跳转至
开发版采用单机部署,无需产品 License 文件。需要多机部署或大规模性能测试? 了解企业版

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 IF EXISTS schema_reference

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。