db.grantRolesToRole()（mongoshメソッド）

定義

db.grantRolesToRole(rolename, roles, writeConcern)

このページではメソッドについて説明します。ただし、データベースコマンドやNode.jsなどの言語固有のドライバーのドキュメントには該当しませんmongosh 。

データベースコマンドについては、grantRolesToRole コマンドを参照してください。

MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。

db.grantRolesToRole()メソッドでは、次の構文を使用します。

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

db.grantRolesToRole()メソッドは次の引数を取ります。

Parameter	タイプ	説明
`rolename`	string	サブロールを付与するロールの名前。
`roles`	配列	継承するロールの配列。
`writeConcern`	ドキュメント	任意。操作の書込み保証（ write concern ）のレベル。詳しくは、書込み保証（write concern）の仕様を参照してください。

db.grantRolesToRole()が実行されるのと同じデータベースに存在するロールを指定するには、ロールの名前を使用してロールを指定します。

"readWrite"

または、次のように、ドキュメントを使用してロールを指定することもできます。

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

別のデータベースに存在するロールを指定するには、ドキュメントを使用してロールを指定します。

このメソッドは、次の環境でホストされている配置で使用できます。

このコマンドは、MongoDB Atlas クラスターではサポートされていません。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

レプリカセットで実行する場合、db.grantRolesToRole() はデフォルトで書込み保証 (write"majority" concern)を使用して実行されます。

ロールはデータベース内の他のロールから権限を継承することができます。admin データベースで作成されたロールは、任意のデータベースのロールから権限を継承できます。

データベースにロールを付与するには、そのデータベースに対してgrantRoleアクションが必要です。

db.grantRolesToRole()次のproductsReaderWriter 操作は、products データベース内のロールを更新して、 productsReaderロールの権限を継承します。

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