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

DROP GRAPH

DROP GRAPH语句用于销毁图或临时图。支持销毁位于当前会话中的 Schema 或指定 Schema 的图。

Note

临时图存在于内存缓存中,当其宿主服务退出时,临时图会被自动销毁。

使用说明

当执行DROP GRAPH语句销毁图时,图数据不会立即从 Storage 服务中被物理删除,即不会立即释放磁盘空间。而是在后续的 RocksDB Compaction(数据压缩)操作中被永久删除。

您可以提交 COMPACT 任务来强制删除物理数据。图数据是否立即被删除,取决于数据在 RocksDB 的 LSM-tree 层次结构中所在的层级。

Note

对非默认 Schema 或其中的对象执行操作时,用户既要通过隐式访问规则或显式USAGE授权获得该 Schema 的访问权,也要具备目标操作所需的权限。Schema 访问校验和目标操作所需的权限校验相互独立,满足其中一项不能替代另一项。Schema 访问控制不适用于临时图、内置 Procedure 和内置 Function。更多信息,请参见 Schema 访问控制。

前提条件

  • 已创建图或临时图。更多信息,请参见 CREATE GRAPH 和 CREATE TEMPORARY GRAPH。
  • 若要销毁图,必须是图的所有者,或具备在图上执行DROP操作的权限,或具备在当前 Schema 执行DROP ANY GRAPH操作的权限。更多信息,请参见角色与权限。
  • 若要销毁临时图,必须是具备角色ADMIN的用户或临时图的所有者。

语法

drop_graph_statement
DROP PROPERTY GRAPH IF EXISTS schema_reference / graph_name temp_graph_name

drop_graph_statement ::=
    'DROP' 'PROPERTY'? 'GRAPH' ('IF EXISTS')? ((schema_reference '/')? graph_name | temp_graph_name)

参数

IF EXISTS

该子句会检查待销毁的图或临时图是否存在。如果不存在,则不会销毁图或临时图,也不会抛出异常。

若不指定该子句,且待销毁的图或临时图不存在,则会抛出异常。

schema_reference

所引用的 Schema 路径。此处即待销毁的图所在的 Schema 路径。

绝对路径或相对路径均可在语句中使用。若想销毁不在当前会话中的 Schema 中的图,则需指定对应 Schema 路径。关于设置和查看 Schema 的更多信息,请参见 SESSION SET 和 SHOW CURRENT_SCHEMA。

graph_name

待销毁的图的名称。

temp_graph_name

待销毁的临时图的名称。必须以井号(#)开头。

示例

销毁当前 Schema 中的图

DROP GRAPH /default_schema/my_graph

上述示例销毁了示例数据集中介绍的图movie。

销毁指定 Schema 中的图

DROP GRAPH /default_schema/my_graph

上述示例销毁了在 CREATE GRAPH 示例部分所创建的my_graph。

销毁临时图

DROP GRAPH IF EXISTS #movie_temporary_graph

上述示例销毁了在 CREATE TEMPORARY GRAPH 中创建的临时图#movie_temporary_graph。