RENAME GRAPH¶
RENAME GRAPH语句用于重命名当前会话中的 Schema 或指定 Schema 的图。
Note
不支持重命名临时图。
Note
对非默认 Schema 或其中的对象执行操作时,用户既要通过隐式访问规则或显式USAGE授权获得该 Schema 的访问权,也要具备目标操作所需的权限。Schema 访问校验和目标操作所需的权限校验相互独立,满足其中一项不能替代另一项。Schema 访问控制不适用于临时图、内置 Procedure 和内置 Function。更多信息,请参见 Schema 访问控制。
前提条件¶
- 已创建图。更多信息,请参见 CREATE GRAPH。
- 若要重命名图,必须是图的所有者,或具备在图上执行
ALTER操作的权限,或具备在对应 Schema 执行ALTER ANY GRAPH操作的权限。更多信息,请参见角色与权限。
语法¶
- rename_graph_statement
rename_graph_statement ::=
'RENAME' 'PROPERTY'? 'GRAPH' (schema_reference '/')? old_graph_name 'TO' (schema_reference '/')? new_graph_name
参数¶
schema_reference¶
所引用的 Schema 路径。此处即待重命名的图所在的 Schema 路径。
- 绝对路径或相对路径均可在语句中使用。若想重命名不在当前会话中的 Schema 中的图,则需指定对应 Schema 路径。关于设置和查看 Schema 的更多信息,请参见 SESSION SET 和 SHOW CURRENT_SCHEMA。
- 重命名图时其 Schema 路径不支持修改。
old_graph_name¶
图当前的名称。
new_graph_name¶
图的新名称。
示例¶
以下示例基于示例数据集。
重命名当前 Schema 的图¶
RENAME GRAPH movie TO movie_renamed
上述示例将图movie重命名为movie_renamed。
重命名指定 Schema 的图¶
RENAME GRAPH /default_schema/my_graph TO /default_schema/my_graph_renamed
上述示例将 CREATE GRAPH 示例部分所创建的my_graph重命名为my_graph_renamed。