Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/graph/rename/
Documentation version: v5.3.2

# RENAME GRAPH

`RENAME GRAPH`语句用于重命名当前会话中的 Schema 或指定 Schema 的图。

Note

不支持重命名临时图。

Note

对非默认 Schema 或其中的对象执行操作时，用户既要通过隐式访问规则或显式`USAGE`授权获得该 Schema 的访问权，也要具备目标操作所需的权限。Schema 访问校验和目标操作所需的权限校验相互独立，满足其中一项不能替代另一项。Schema 访问控制不适用于临时图、内置 Procedure 和内置 Function。更多信息，请参见 [Schema 访问控制](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/schema-access-control/)。

## 前提条件

- 已创建图。更多信息，请参见 [CREATE GRAPH](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/graph/create/)。
- 若要重命名图，必须是图的所有者，或具备在图上执行`ALTER`操作的权限，或具备在对应 Schema 执行`ALTER ANY GRAPH`操作的权限。更多信息，请参见[角色与权限](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/)。

## 语法

语法图源码

 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](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/sessions/set/) 和 [SHOW CURRENT_SCHEMA](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-current-schema/)。
- 重命名图时其 Schema 路径不支持修改。

### `old_graph_name`

图当前的名称。

### `new_graph_name`

图的新名称。

## 示例

以下示例基于[示例数据集](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/overview/example-dataset/)。

### 重命名当前 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](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/ddl/graph/create/#schema_1) 示例部分所创建的`my_graph`重命名为`my_graph_renamed`。