DROP SCOPE
- reference
The DROP SCOPE
statement enables you to delete a scope.
Syntax
drop-scope ::= 'DROP' 'SCOPE' ( namespace ':' )? bucket '.' scope ( 'IF' 'EXISTS' )?
namespace |
(Optional) An identifier that refers to the namespace of the bucket which contains the scope you want to delete.
Currently, only the |
bucket |
(Required) An identifier that refers to the bucket which contains the scope you want to delete. |
scope |
(Required) An identifier that refers to the name of the scope that you want to delete. |
If there is a hyphen (-) inside the bucket name or the scope name, you must wrap that part of the path in backticks (` `).
For example, default:`travel-sample` indicates the travel-sample keyspace in the default namespace.
|
IF EXISTS Clause
The optional IF EXISTS
clause enables the statement to complete successfully when the specified scope doesn’t exist.
If the scope does not exist within the specified bucket, then:
-
If this clause is not present, an error is generated.
-
If this clause is present, the statement does nothing and completes without error.
Example
This statement deletes a scope called events
in the travel-sample
bucket.
DROP SCOPE `travel-sample`.events
Related Links
-
An overview of scopes and collections is provided in Scopes and Collections.
-
Step-by-step procedures for management are provided in Manage Scopes and Collections.
-
Refer to Scopes and Collections API to manage scopes and collections with the REST API.
-
Refer to the reference page for the collection-manage command to manage scopes and collections with the CLI.