Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-roles/
Documentation version: v5.3.2

# SHOW ROLES

`SHOW ROLES`命令返回授予当前用户或特定用户的角色信息。

返回信息如下表：

 | 列 | 描述
 | `name` | 角色的名称。
 | `owner` | 角色的拥有者（OWNER）。
 | `comment` | 角色的描述。

## 前提条件

- 任意用户都可以查询授予自己的角色。
- 要查询授予其他用户的角色，当前用户必须具有`ADMIN`角色。

## 语法

语法图源码

 show_roles_command  

````
show_roles_command ::=
    'SHOW' 'ROLES' ('FOR' 'USER' user_name)?

````

## 参数

### `FOR`

指定是否查询授予特定用户的角色。

如果未指定`FOR`子句，则默认查询授予当前用户的角色。

### `user_name`

待查询其角色的用户名称。要查询已加入当前服务组的用户，请参见 [SHOW USERS](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-users/)。

## 示例

### 查询授予当前用户的角色

````
SHOW ROLES

````

返回：

````
+-------+-------+--------------+
| name  | owner | comment      |
+-------+-------+--------------+
| ADMIN | root  | Builtin role |
+-------+-------+--------------+

````

### 查询授予特定用户的角色

````
SHOW ROLES FOR USER user1

````

返回：

````
+-------+-------+-----------------------------------+
| name  | owner | comment                           |
+-------+-------+-----------------------------------+
| role1 | root  | This is new description for role1 |
+-------+-------+-----------------------------------+

````