Source: https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/privilege-reference/
Documentation version: v5.3.2

# 权限参考

本页按资源类型列出可授予的操作权限。首次为用户开通权限，请按[为用户配置访问权限](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/configure-user-access/)操作；直接授权、角色和 Owner 的含义见[授权概述](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/)。

## 资源对象

悦数图数据库开发版支持在以下资源对象上授予权限：服务组、Catalog、Schema、图类型、图、点类型、边类型、点属性、边属性和用户定义过程（UDP）。

以下两类资源不支持直接授权：

- 临时图不支持`GRANT`或`REVOKE`。只有临时图 Owner 或具有`ADMIN`角色的用户可以访问临时图。
- 用户定义函数（UDF）具有 Owner，但不能直接对`FUNCTION`对象执行`GRANT`或`REVOKE`。具体说明请参见[用户定义函数](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/privilege-reference/#function)。

## 可以授予的权限

### 服务组（`SVCGRP`）

 | 操作 | 描述
 | `CONNECT` | 连接服务组。

### Catalog

 | 操作 | 描述
 | `CREATE SCHEMA` | 在 Catalog 中创建 Schema。

### Schema

 | 操作 | 描述
 | `USAGE` | 查看、选择和引用 Schema。操作其中的对象仍需相应权限。
 | `DROP` | 删除 Schema。
 | `CREATE GRAPH TYPE` | 在 Schema 中创建图类型。
 | `ALTER ANY GRAPH TYPE` | 修改 Schema 中的任意图类型。
 | `DROP ANY GRAPH TYPE` | 删除 Schema 中的任意图类型。
 | `CREATE GRAPH` | 在 Schema 中创建图。
 | `INSERT ANY GRAPH` | 向 Schema 中的任意图插入点和边。
 | `MATCH ANY GRAPH` | 读取 Schema 中任意图的点和边。
 | `DELETE ANY GRAPH` | 删除 Schema 中任意图的点和边。
 | `UPDATE ANY GRAPH` | 更新 Schema 中任意图的点和边。
 | `ALTER ANY GRAPH` | 重命名任意图、修改图注释或管理图的 TTL 设置。
 | `DROP ANY GRAPH` | 删除 Schema 中的任意图。
 | `CREATE INDEX` | 在 Schema 中创建索引。
 | `DROP ANY INDEX` | 删除 Schema 中的任意索引。
 | `CREATE PROCEDURE` | 在 Schema 中创建 UDP。
 | `ALTER ANY PROCEDURE` | 修改 Schema 中的任意 UDP。
 | `EXECUTE ANY PROCEDURE` | 调用 Schema 中的任意 UDP。
 | `DROP ANY PROCEDURE` | 删除 Schema 中的任意 UDP。
 | `CREATE FUNCTION` | 在 Schema 中创建 UDF。
 | `DROP ANY FUNCTION` | 删除 Schema 中的任意 UDF。

### 图类型（`GRAPH TYPE`）

 | 操作 | 描述
 | `ALTER` | 修改图类型。
 | `DROP` | 删除图类型。

### 图（`GRAPH`）

 | 操作 | 描述
 | `MATCH` | 读取图中的点和边。
 | `INSERT` | 向图中插入点和边。
 | `UPDATE` | 更新图中的点和边。
 | `DELETE` | 删除图中的点和边。
 | `ALTER` | 重命名图、修改图注释或管理图的 TTL 设置。
 | `DROP` | 删除图。
 | `INDEX` | 在图上创建、修复或删除索引。

### 点类型和边类型（`NODE TYPE`和`EDGE TYPE`）

 | 操作 | 描述
 | `MATCH` | 读取该类型的元素及其属性。
 | `INSERT` | 插入该类型的元素及其属性。
 | `UPDATE` | 更新该类型的元素及其属性。
 | `DELETE` | 删除该类型的元素及其属性。

### 点属性和边属性（`NODE PROPERTY`和`EDGE PROPERTY`）

 | 操作 | 描述
 | `MATCH` | 读取属性值。
 | `INSERT` | 插入元素时指定属性值。
 | `UPDATE` | 更新属性值。

### 用户定义过程（`PROCEDURE`）

 | 操作 | 描述
 | `EXECUTE` | 调用 UDP。
 | `ALTER` | 修改 UDP。
 | `DROP` | 删除 UDP。

### 用户定义函数（`FUNCTION`）

当前不支持直接在`FUNCTION`对象上授予或撤销权限。UDF Owner 可以删除其拥有的 UDF。要控制 UDF 的创建和删除，请在其所属 Schema 上使用`CREATE FUNCTION`和`DROP ANY FUNCTION`。

## 权限适用范围

上级资源上的权限可以覆盖下级资源，适用范围如下：

 | 授予的权限 | 适用范围
 | Schema 上的`MATCH ANY GRAPH`、`INSERT ANY GRAPH`、`UPDATE ANY GRAPH`或`DELETE ANY GRAPH` | Schema 中所有图，以及图中相应的点、边和属性操作。
 | Schema 上的`ALTER ANY GRAPH`或`DROP ANY GRAPH` | Schema 中所有图。
 | Schema 上的`ALTER ANY GRAPH TYPE`或`DROP ANY GRAPH TYPE` | Schema 中所有图类型。
 | Schema 上的`ALTER ANY PROCEDURE`、`EXECUTE ANY PROCEDURE`或`DROP ANY PROCEDURE` | Schema 中所有 UDP。
 | Schema 上的`DROP ANY FUNCTION` | Schema 中所有 UDF。
 | Schema 上的`CREATE INDEX`或`DROP ANY INDEX` | Schema 中任意图上的对应索引操作。
 | 图上的`MATCH`、`INSERT`、`UPDATE`或`DELETE` | 该图中相应的点、边和属性操作。
 | 点类型或边类型上的数据操作 | 该类型及其属性上的相应操作。

Important

Schema `USAGE`是独立权限。访问非默认 Schema 中的对象时，用户必须同时拥有该 Schema 的`USAGE`和目标操作所需的权限。

## 资源 Owner 可以执行的操作

Owner（所有者）是负责管理某个资源的用户。即使没有显式授权，Owner 也可以对其拥有的资源执行以下操作：

 | 资源类型 | Owner 可以执行的操作 | 是否支持`ALTER OWNER`
 | Schema | 使用和删除 Schema；授予或撤销该 Schema 上的权限 | 是
 | 图类型 | 修改和删除图类型；授予或撤销该图类型上的权限 | 是
 | 图 | 查询、写入、修改和删除数据；修改或删除图；管理索引；授予或撤销该图上的权限 | 是
 | UDP | 调用、修改和删除 UDP；授予或撤销该 UDP 上的权限 | 是
 | UDF | 删除 UDF | 否

资源 Owner 不会因此自动获得父级 Schema 的访问权限。访问非默认 Schema 中的资源时，Owner 仍需要该 Schema 的`USAGE`。

## 相关命令

- 授予或撤销权限：[GRANT](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/grant-privilege/) 和 [REVOKE](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/revoke-privilege/)。
- 查看授权记录：[SHOW PRIVILEGES](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-privileges/)。
- 查看资源所有权：[SHOW OBJECTS](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-objects/)。