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

# ALTER ROLE

`ALTER ROLE`修改当前服务组中角色的描述，不改变角色包含的权限。

## 前提条件

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

要更改角色，需要是角色 Owner（所有者）或具有当前服务组的`ADMIN`角色。

## 语法

语法图BNF

 alter_role_command  

````
alter_role_command ::=
    'ALTER' 'ROLE' role_name 'SET' 'COMMENT' '=' '"' comment '"'

````

## 参数

### `role_name`

待修改的角色名称。

### `comment`

角色的新描述。描述必须是字符串字面量。

## 示例

示例使用已创建的`role1`。

````
ALTER ROLE role1 SET COMMENT = "This is new description for role1"

````

使用 [SHOW ALL ROLES](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-all-roles/) 检查`role1`的`comment`，应为新描述。