dropSearchIndex
定義
バージョン 7.0 の新機能: (6.0.7 以降でも利用可能)
既存の Atlas Search インデックスを削除します。
mongosh
メソッド db.collection.dropSearchIndex()
はupdateSearchIndex
データベースコマンドを囲むラッパーを提供します。
重要
このコマンドは、 MongoDB Atlas でホストされている配置でのみ実行でき、 サーバーレスインスタンス で はサポートされていません 。
構文
コマンド構文:
db.runCommand( { dropSearchIndex: "<collection name>", id: "<index Id>", name: "<index name>" } )
コマンドフィールド
dropSearchIndex
コマンドは、次のフィールドがあります。
フィールド | タイプ | 必要性 | 説明 |
---|---|---|---|
dropSearchIndex | string | 必須 | 削除するインデックスを含むコレクションの名前。 |
id | string | 条件付き |
フィールドまたは |
name | string | 条件付き | 削除するインデックスの名前。 フィールドまたは |
動作
dropSearchIndex
コマンドの実行後、コマンドからの応答を受け取ってからインデックスが削除されるまでの間にタイムラグが生じる可能性があります。
検索インデックスのステータスを確認するには、 $listSearchIndexes
集計ステージを使用します。 インデックスが削除されると、そのインデックスは$listSearchIndexes
の出力に表示されなくなります。
アクセス制御
配置でアクセス制御が強制される場合、 dropSearchIndex
コマンドを実行するユーザーは、データベースまたはコレクションに対するdropSearchIndex
特権アクションを持っている必要があります。
{ resource: { db : <database>, collection: <collection> }, actions: [ "dropSearchIndex" ] }
組み込みのdbAdmin
} ロールとreadWrite
ロールによってdropSearchIndex
特権が付与されます。 次の例では、 qa
データベースでreadWrite
ロールを付与しています。
db.grantRolesToUser( "<user>", [ { role: "readWrite", db: "qa" } ] )
出力
dropSearchIndex
コマンドが成功すると、次の結果が返されます。
{ ok: 1 }
例
次の例では、 contacts
コレクションにあるsearchIndex01
という名前の検索インデックスを削除します。
db.runCommand( { dropSearchIndex: "contacts", name: "searchIndex01" } )