DETACH DATABASE

On this page

Takes an unlimited storage database offline. The data remains on remote storage and should be deleted separately if you wish to completely remove it.

The workspace will keep a reference to the database after it is detached. Hence you can simply DETACH and ATTACH a database by using its name.

Check here for the permissions required to use this command.

Syntax

DETACH DATABASE remote_database_name [AT MILESTONE "milestone_name" | KILL]

Arguments

milestone_name

A quoted string that is the milestone to detach the database at.

Remarks

If KILL is specified, the following apply:
- The target database is synced to unlimited storage and the database is detached.
- Note that this operation does not incur data loss. Previously, a workload needed to finish before the database could be moved to remote storage. This option kills the running workload and moves the database to remote storage instantly.
- During this operation, running queries will be interrupted and may fail during execution.
After detaching a database, you can reattach the database using ATTACH DATABASE. The reattach can be done optionally at a milestone or a point in time, and with the same or a different database name.
This command cannot be run on system databases.
Refer to the Permission Matrix for the required permission.

Example

DETACH DATABASE db AT MILESTONE "m";

DETACH DATABASE db KILL;

Detach a Database from a Workspace

To detach a database from a workspace, execute the following command:

DETACH DATABASE db_name FROM WORKSPACE wspace1

where wspace1 is the unique name of the workspace in the workspace group.

Last modified: April 23, 2025

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

(Optional) Run the following command to view the associated signature files.
Shell
```
curl undefined
```
Download the signature file from the SingleStore release server.
- Option 1: Click the Download Signature button next to the SingleStore file.
- Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.
- Option 3: Run the following command to download the signature file.
  Shell
```
curl -O undefined
```

After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

Shell

echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
      --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
      --bundle undefined \
      --new-bundle-format -

Verified OK