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

planCacheListFilters

項目一覧

  • 定義
  • 互換性
  • 構文
  • コマンドフィールド
  • 必要なアクセス権
  • 出力
planCacheListFilters

コレクションの プランキャッシュクエリシェイプ に関連付けられている インデックスフィルター を一覧表示します。

次の値を返します。インデックス フィルターを一覧表示するドキュメント。 詳しくは出力を参照してください。

MongoDB 8.0以降では、インデックス フィルターを追加する 代わりに、 クエリ設定を使用します 。 インデックス フィルターは MongoDB 8.0以降非推奨です。

クエリ設定は、インデックス フィルターよりも多くの機能を持ちます。 また、インデックス フィルターは永続的ではなく、すべてのクラスター ノードに対してインデックス フィルターを簡単に作成することはできません。 クエリ設定を追加して例を探すには、 setQuerySettingsを参照してください。

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

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

重要

このコマンドは、M 0 、M 2 、M 5クラスターではサポートされていません。 詳細については、「サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

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

db.runCommand(
{
planCacheListFilters: <collection>
}
)

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

フィールド
タイプ
説明

planCacheListFilters

string

コレクションの名前。

comment

any

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

コメントには、有効な BSON 型(string, integer, object, array など)を使用できます。

ユーザーには、 planCacheIndexFilterアクションを含むアクセス権が必要です。

planCacheListFiltersコマンドは、次の形式のドキュメントを返します。

{
"filters" : [
{
"query" : <query>
"sort" : <sort>,
"projection" : <projection>,
"collation" : <collation>,
"indexes" : [
<index1>,
...
]
},
...
],
"ok" : 1
}
planCacheListFilters.filters

インデックス フィルター情報を含むドキュメントの配列。

各ドキュメントには、次のフィールドが含まれています。

planCacheListFilters.filters.query

このフィルターに関連付けられたクエリ述語。 queryにはインデックス フィルターの作成に使用される特定の値が表示されていますが、述語の値は重要ではありません。クエリ述語は、値のみが異なる類似のクエリをカバーします。

たとえば、 { "type": "electronics", "status" : "A" }query述語は次のクエリ述語をカバーします。

{ type: "food", status: "A" }
{ type: "utensil", status: "D" }
planCacheListFilters.filters.sort

このフィルターに関連付けられているソート。 空のドキュメントを指定できます。

planCacheListFilters.filters.projection

このフィルターに関連付けられたプロジェクション。 空のドキュメントを指定できます。

planCacheListFilters.filters.collation

このフィルターに関連付けられている照合。 空のドキュメントを指定できます。

planCacheListFilters.filters.indexes

プランキャッシュクエリシェイプのインデックスの配列。

プランキャッシュのクエリシェイプは、次のフィールドの組み合わせです。

最適なクエリプランを選択するために、クエリオプティマイザはindexesコレクションスキャンを評価します。

planCacheListFilters.ok

コマンドのステータスです。

Tip

以下も参照してください。

戻る

planCacheClearFilters