db.grantRolesToRole()

On this page本页内容

Definition定义

db.grantRolesToRole(rolename, roles, writeConcern)

Grants roles to a user-defined role.将角色授予用户定义的角色。

The grantRolesToRole method uses the following syntax:grantRolesToRole方法使用以下语法：

db.grantRolesToRole( "<rolename>", [ <roles> ], { <writeConcern> } )

The grantRolesToRole method takes the following arguments:grantRolesToRole方法采用以下参数：

Parameter参数Type类型Description描述
rolename string The name of the role to which to grant sub roles.要向其授予子角色的角色的名称。
roles array An array of roles from which to inherit.要从中继承的角色数组。
writeConcern document Optional.可选。The level of write concern for the modification. 修改的写入关注级别。The writeConcern document takes the same fields as the getLastError command.writeConcern文档采用与getLastError命令相同的字段。

In the roles field, you can specify both built-in roles and user-defined roles.在roles字段中，可以指定内置角色和用户定义角色。

To specify a role that exists in the same database where db.grantRolesToRole() runs, you can either specify the role with the name of the role:要指定运行db.grantRolesToRole()的同一数据库中存在的角色，可以使用该角色的名称指定该角色：

"readWrite"

Or you can specify the role with a document, as in:也可以通过文档指定角色，如中所示：

{ role: "<role>", db: "<database>" }

To specify a role that exists in a different database, specify the role with a document.要指定存在于其他数据库中的角色，请使用文档指定该角色。

The db.grantRolesToRole() method wraps the grantRolesToRole command.db.grantRolesToRole()方法包装grantRolesToRole命令。

Behavior行为

Replica set复制集

If run on a replica set, db.grantRolesToRole() is executed using majority write concern by default.如果在副本集上运行，默认情况下，db.grantRolesToRole()将使用majority写入关注点执行。

Scope作用域

A role can inherit privileges from other roles in its database. 角色可以从其数据库中的其他角色继承权限。A role created on the admin database can inherit privileges from roles in any database.在admin数据库上创建的角色可以从任何数据库中的角色继承权限。

Required Access所需访问权限

You must have the grantRole action on a database to grant a role on that database.必须对数据库执行grantRole操作，才能在该数据库上授予角色。

Example示例

The following grantRolesToRole() operation updates the productsReaderWriter role in the products database to inherit the privileges of productsReader role:以下grantRolesToRole()操作更新产品数据库中的productsReaderWriter角色，以继承productsReader角色的权限：

use products
db.grantRolesToRole(
    "productsReaderWriter",
    [ "productsReader" ],
    { w: "majority" , wtimeout: 5000 }
)