DROP SCHEMA¶
DROP SCHEMA语句用于销毁当前 Catalog 中的 Schema。Schema 被销毁后,Schema 中的所有对象也会被删除。
系统创建的默认 Schema /default_schema不能被销毁。
Note
对非默认 Schema 或其中的对象执行操作时,用户既要通过隐式访问规则或显式USAGE授权获得该 Schema 的访问权,也要具备目标操作所需的权限。Schema 访问校验和目标操作所需的权限校验相互独立,满足其中一项不能替代另一项。Schema 访问控制不适用于临时图、内置 Procedure 和内置 Function。更多信息,请参见 Schema 访问控制。
前提条件¶
- 已创建 Schema。更多信息,请参见 CREATE SCHEMA。
- 待销毁的 Schema 中不包含资源对象。
- 具备对指定 Schema 执行
DROP操作的权限。更多信息,请参见角色与权限。
语法¶
- drop_schema_statement
drop_schema_statement ::=
'DROP' 'SCHEMA' ('IF EXISTS')? schema_reference
参数¶
IF EXISTS¶
该子句会检查待销毁的 Schema 是否存在于路径中。如果不存在,则不会销毁 Schema,也不会抛出异常。
若不指定该子句,且待销毁的 Schema 不存在于路径中,则会抛出异常。
schema_reference¶
所引用的 Schema 路径。此处即待销毁的 Schema 的路径。
路径区分大小写,必须与现有的 Schema 路径匹配。绝对路径或相对路径均可在语句中使用。
示例¶
使用绝对路径销毁 Schema¶
DROP SCHEMA IF EXISTS /test/my_schema1
上述示例销毁在 CREATE SCHEMA 的示例部分中所创建的路径为/test/my_schema1的 Schema。
使用相对路径销毁 Schema¶
'''
// 创建 Schema
CREATE SCHEMA IF NOT EXISTS /test/my_schema1
'''
'''
// 为当前会话设置 Schema
SESSION SET SCHEMA /test/my_schema1
'''
'''
// 使用相对路径创建 Schema
CREATE SCHEMA IF NOT EXISTS ../my_schema2
'''
'''
// 使用相对路径销毁 Schema
DROP SCHEMA IF EXISTS ../my_schema2
'''
上述示例销毁在当前会话中的 Schema 为/test/my_schema1的情况下,销毁了路径为/test/my_schema2的 Schema。