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

# GRANT ROLE

`GRANT ROLE`将当前服务组中的一个或多个自定义角色授予用户。每个用户最多拥有 16 个自定义角色。

## 前提条件

先[连接 Graph 服务](https://dev-docs.yueshu.com.cn/v5.3.2/get-started/first-query/#connect)，在 GQL 客户端中执行命令。

- 要给用户授予角色，需要具有当前服务组的`ADMIN`角色。
- 待授予角色的用户已创建并被邀请到当前服务组中。更多信息，请参见[创建用户](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authentication/manage-users/)和 [INVITE USER](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/invite-user/)。

- 待授予的角色已通过 [CREATE ROLE](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/create-role/) 创建。

## 限制条件

角色`ADMIN`是服务组 Owner 专有的，不能通过`GRANT ROLE`授予其他用户。

## 语法

语法图BNF

 grant_role_command  

````
grant_role_command ::=
    'GRANT' 'ROLE' role_name (',' role_name)* 'TO' 'USER' user_name

````

## 参数

### `role_name`

待授予的角色名称。

### `user_name`

接收角色的用户名。

## 示例

示例使用已创建的`role1`和已加入服务组的用户`user1`。

````
GRANT ROLE role1 TO USER user1

````

使用 [SHOW ROLES FOR USER](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-roles/) 检查`user1`的角色列表，应包含`role1`。角色中的权限会与用户已有权限合并生效。