db.getRole()
在本页面
Definition
db.getRole(* rolename ， args *)- 返回该角色从中继承特权的角色。 (可选)该方法还可以返回所有角色的特权。
从包含角色的数据库中运行db.getRole()。该命令可以检索user-defined roles和built-in roles的信息。
db.getRole()方法接受以下参数：
| Parameter | Type | Description |
|---|---|---|
rolename |
string | 角色名称。 |
args |
document | 可选的。指定其他参数的文档。 |
args文档支持以下字段：
| Field | Type | Description |
|---|---|---|
showBuiltinRoles |
boolean | 可选的。当rolesInfo字段设置为1时，请将showBuiltinRoles设置为true以在输出中包括built-in roles。默认情况下，此字段设置为false，并且rolesInfo: 1的输出仅显示user-defined roles。 |
showPrivileges |
boolean | 可选的。将字段设置为true以显示角色特权，包括从其他角色继承的特权和直接定义的特权。默认情况下，该命令仅返回该角色从中继承特权的角色，并且不返回特定特权。 |
Required Access
要查看角色的信息，必须为您明确授予该角色或在角色的数据库上具有viewRole action。
Examples
以下操作返回在products数据库上定义的角色associate的角色继承信息：
use products
db.getRole( "associate" )
以下操作返回在products数据库中定义的角色associate的角色继承信息和特权：
use products
db.getRole( "associate", { showPrivileges: true } )