dropRole （データベースコマンド）

定義

dropRole: コマンドを実行するデータベースからユーザー定義ロールを削除します。
Tip
In mongosh, this command can also be run through the db.dropRole() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

互換性

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

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

重要

This command is not supported in MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

構文

このコマンドの構文は、次のとおりです。

db.runCommand(
   {
     dropRole: "<role>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

コマンドフィールド

コマンドには次のフィールドがあります:

フィールド	タイプ	説明
`dropRole`	string	データベースから削除するユーザー定義ロールの名前。
`writeConcern`	ドキュメント	任意。操作の書込み保証（ write concern ）のレベル。詳しくは、書込み保証（write concern）の仕様を参照してください。
`comment`	any	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

動作

認証

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

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

必要なアクセス権

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

例

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

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

戻る

createRole

dropAllRolesFromDatabase