DETACH DATABASE
On this page
Takes an unlimited storage database offline.
The workspace will keep a reference to the database after it is detached.DETACH
and ATTACH
a database by using its name.
Check here for the permissions required to use this command.
Syntax
DETACH DATABASE remote_
Arguments
milestone_ name
A quoted string that is the milestone to detach the database at.
Remarks
-
If
FORCE
is specified, the following applies:-
It allows you to terminate ongoing uploads to remote storage and forcibly detaches the database.
This can be useful in situations where, for example, the detach process is unable to upload blobs to remote storage or encounters a connection loss error. Typically, scenarios in which the database cannot be detached normally and the process may become stuck. -
It is applicable only when unlimited storage is used and is intended primarily for emergency recovery situations.
It is not recommended for routine use. -
This operation only detaches the database, it does not drop or delete it.
-
SingleStore immediately stops all ongoing uploads and detaches the database.
Any data not yet uploaded to remote storage such as, columnstore blobs, rowstore data, or logs, will be lost, resulting in potential data loss. To reattach the database, you can use the ATTACH DATABASE
command.SingleStore will restore the database, however any data that was not previously uploaded to remote storage will be missing after reattachment.
-
-
If
FORCE
is not specified, the following applies:-
All the changes that have not yet been uploaded are successfully uploaded into remote storage before detaching.
-
-
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: July 15, 2025