db.dropRole()
定義
db.dropRole( rolename, writeConcern )
メソッドを実行するデータベースからユーザー定義ロールを削除します。
重要
mongosh メソッド
このページでは、
mongosh
メソッドについて説明します。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。データベースコマンドについては、
dropRole
コマンドを参照してください。MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。
db.dropRole()
メソッドは次の引数を取ります。Parameterタイプ説明rolename
stringデータベースから削除するユーザー定義ロールの名前。writeConcern
ドキュメント任意。 操作の 書込み保証( write concern ) のレベル。 詳しくは、 書込み保証(write concern) の仕様を参照してください。
動作
認証
mongod
でロールが削除されると、以前に認証されたユーザーは データベースにログインしたままですが、ロールの特権をすぐに失います。
mongos
でロールが削除されても、以前に認証されたユーザーは データベースにログインしたままですが、 キャッシュ が更新されるとロールの特権が失われます。 キャッシュは、 userCacheInvalidationIntervalSecs
パラメータで指定された時間の後に自動的に更新されるか、 invalidateUserCache
コマンドを実行すると手動で更新されます。
レプリカセット
レプリカセットで実行する場合、 db.dropRole()
はデフォルトで"majority"
書込み保証を使用して実行されます。
必要なアクセス権
例
次の操作により、 products
データベースからreadPrices
ロールが削除されます。
use products db.dropRole( "readPrices", { w: "majority" } )