Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

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"書込み保証を使用して実行されます。

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

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

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

戻る

db.createRole