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

# CREATE ROLE

`CREATE ROLE`在当前服务组中创建自定义角色。新角色尚未包含权限，需使用 [GRANT](https://dev-docs.yueshu.com.cn/v5.3.2/server-admin/authorization/grant-privilege/) 添加权限。

## 前提条件

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

要创建角色，需要具有当前服务组的`ADMIN`角色。

## 语法

语法图BNF

 create_role_command  

````
create_role_command ::=
    'CREATE' 'ROLE' ('IF NOT EXISTS')? role_name  ('COMMENT' '"' comment '"')?

````

## 参数

### `IF NOT EXISTS`

存在同名角色时跳过创建，保留原有描述和权限。省略该子句时，同名角色会导致命令报错。

### `role_name`

新角色的名称。`role_name`必须是常规标识符。有关标识符的更多信息，请参见[标识符命名规则](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/overview/keywords-identifiers/)。

### `comment`

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

## 示例

````
CREATE ROLE IF NOT EXISTS role1 COMMENT "This is role1"

````

使用 [SHOW ALL ROLES](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-all-roles/) 检查结果，应看到`name`为`role1`、`comment`为`This is role1`的记录。