DROP WORKSPACE
On this page
Deletes the specified workspace.
Syntax
DROP WORKSPACE [ IF EXISTS ]
{ ID '<workspace_ID>' | '<workspace_name>' }
[ IN GROUP { ID '<group_ID>' | '<group_name>' } ]
[ WAIT ON TERMINATED ]Arguments
-
workspace_,ID workspace_: ID or name of the workspace to delete.name -
group_,ID group_: ID or name of the workspace group that contains the workspace.name
Remarks
-
Specify the
IF EXISTSclause to attempt the delete operation only if a workspace with the specified ID or name exists. -
The
IN GROUPclause specifies the ID or name of the workspace group that contains the workspace to delete. -
Specify the
WAIT ON TERMINATEDclause to pause query execution until the workspace is in theTERMINATEDstate. -
All the databases attached to a workspace are detached when the workspace is deleted (terminated).
Example
The following command deletes a workspace named examplews in a workspace named s2wsg:
DROP WORKSPACE IF EXISTS 'examplews' IN GROUP 's2wsg';
Last modified: January 30, 2025