db.grantRolesToRole()

Definition定义

db.grantRolesToRole(rolename, roles, writeConcern)

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

Important

mongosh Method

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

For the database command, see the grantRolesToRole command.

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.

For the legacy mongo shell documentation, refer to the documentation for the corresponding MongoDB Server release:

mongo shell v4.4

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

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

The db.grantRolesToRole() method takes the following arguments:db.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 operation. 操作的写入关注级别。See Write Concern Specification. 请参阅写入关注规范。

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.若要指定其他数据库中存在的角色，请使用文档指定该角色。

Behavior行为

Required Access所需访问权限

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

Example实例

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

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