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

定義

db.dropRole( rolename, writeConcern )

メソッドを実行するデータベースからユーザー定義のロールを削除します。

重要

mongosh メソッド

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

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

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

The db.dropRole() method takes the following arguments:

Parameter	タイプ	説明
`rolename`	string	データベースから削除するユーザー定義ロールの名前。
`writeConcern`	ドキュメント	任意。操作の書込み保証（ write concern ）のレベル。詳しくは、書込み保証（write concern）の仕様を参照してください。

互換性

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

重要

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

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

認証

mongodでロールが削除されると、以前に認証されたユーザーはデータベースにログインしたままですが、ロールの特権をすぐに失います。

mongosでロールが削除されても、以前に認証されたユーザーはデータベースにログインしたままですが、キャッシュが更新されるとロールの特権が失われます。キャッシュは、 userCacheInvalidationIntervalSecsパラメータで指定された時間の後に自動的に更新されるか、 invalidateUserCacheコマンドを実行すると手動で更新されます。

レプリカセット

If run on a replica set, db.dropRole() is executed using "majority" write concern by default.

必要なアクセス権

データベースからロールを削除するには、データベースに対してdropRoleアクションが必要です。

例

次の操作により、 productsデータベースからreadPricesロールが削除されます。

use products
db.dropRole( "readPrices", { w: "majority" } )

戻る

db.createRole

db.dropAllRoles