クエリシェイプ

クエリシェイプは、類似したクエリをグループ化する仕様のセットです。 仕様には、フィルター、ソート、プロジェクション、集計パイプラインステージ、名前空間などがあります。 同様の仕様を持つクエリは、同じクエリシェイプを持ちます。

MongoDB 8.0以前のバージョンでは、既存のプランキャッシュクエリシェイプは次をサポートしています。

• プランキャッシュシナリオでのクエリ プラン作成。

• 非推奨のインデックスフィルター。 （ MongoDB 8.0以降では、新しいクエリシェイプに新しいクエリ設定を使用します。）

• 集計パイプライン のサブセット。

MongoDB 8.0以降、新しいクエリシェイプは次の機能をサポートします。

• クエリ設定。これはsetQuerySettingsで追加できます。 （このページの後半で示すように、クエリ設定はクエリシェイプのインデックスと実行設定を指定します。）

• $queryStatsクエリシェイプ統計

• フィールドと操作は プランキャッシュクエリシェイプによってもサポートされています。 たとえば、 filter 、 sort 、 projection 。

• find 、 distinct 、 aggregateコマンドで使用できるフィールドとオペランドの過半数。 コマンドのフィールドとオペランドを表示するには、各コマンドページの「シンタックス」セクションを参照してください。

• コマンド、 コマンド、および コマンドの全体的な構造。これらは既存の プランキャッシュクエリシェイプシェイプfind よりも幅広いクエリシェイプをサポートします。aggregationdistinct

• 操作拒否フィルターは、指定されたクエリシェイプを持つfind 、 aggregation 、およびdistinctコマンドをブロックします。

• 集計パイプライン全体 。

MongoDB 8.0以降では、 $querySettingsパイプラインステージを使用して、各クエリシェイプに指定されたクエリ設定を返すことができます。

db.pizzaOrders.insertMany( [
   { _id: 0, type: "pepperoni", size: "small", price: 19,
     totalNumber: 10, orderDate: ISODate( "2023-03-13T08:14:30Z" ) },
   { _id: 1, type: "pepperoni", size: "medium", price: 20,
     totalNumber: 20, orderDate: ISODate( "2023-03-13T09:13:24Z" ) },
   { _id: 2, type: "pepperoni", size: "large", price: 21,
     totalNumber: 30, orderDate: ISODate( "2023-03-17T09:22:12Z" ) },
   { _id: 3, type: "cheese", size: "small", price: 12,
     totalNumber: 15, orderDate: ISODate( "2023-03-13T11:21:39.736Z" ) }
] )

find: "pizzaOrders",
filter: {
   orderDate: { $gt: ISODate( "2023-01-20T00:00:00Z" ) }
},
sort: {
   totalNumber: 1
},
$db: "test"

db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2024-05-10T05:15:35Z" ) } } ).
   sort( { totalNumber: 1 }
)
db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2024-02-05T07:07:16Z" ) } } ).
   sort( { totalNumber: 1 }
)
db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2023-03-08T08:12:25Z" ) } } ).
   sort( { totalNumber: 1 }
)

queryShapeHash: 'AB8ECADEE8F0EB0F447A30744EB4813AE7E0BFEF523B0870CA10FCBC87F5D8F1'
planCacheShapeHash: '48E51110'

db.pizzaOrders.explain().find(
   { orderDate: { $gt: ISODate( "2023-01-20T00:00:00Z" ) } } ).
   sort( { price: 1 }
)

queryShapeHash: 'AC1ECADBE8F1EB0F417A30741AB4813BE7E0BFEF523B0870CA11FCBC87F1A8B2'
planCacheShapeHash: '31A52130'