$querySettings (aggregation)

本页内容

定义

语法
命令字段
示例
了解更多

定义

$querySettings

新版本8.0.

返回之前使用setQuerySettings添加的查询设置。这些设置应用于整个集群。集群在关闭后保留这些设置。

语法

如果你使用多个管道阶段，请将$querySettings放在管道的第一位。

db.aggregate( [
   { $querySettings: { showDebugQueryShape: <boolean> } },
   // Add any additional pipeline stages after $querySettings
   ...
] )

命令字段

$querySettings包含此字段

字段	类型	必要性	描述
`showDebugQueryShape`	布尔型	可选	如果 `true`，则 `$querySettings` 返回查询形状输出的调试版本。您将在下一节中看到一个示例。有关输出详细信息，请参阅查询形状。默认值为 `false`。

示例

以下示例创建了一个集合，添加了查询设置，并返回了设置

创建示例集合和索引

运行

// Create pizzaOrders collection
db.pizzaOrders.insertMany( [
   { _id: 0, type: "pepperoni", totalNumber: 5,
     orderDate: new Date( "2024-01-15T12:00:00Z" ) },
   { _id: 1, type: "cheese", totalNumber: 15,
     orderDate: new Date( "2024-01-23T11:12:32Z" ) },
   { _id: 2, type: "vegan", totalNumber: 20,
     orderDate: new Date( "2024-03-20T10:01:12Z" ) }
] )
// Create ascending index on orderDate field
db.pizzaOrders.createIndex( { orderDate: 1 } )
// Create ascending index on totalNumber field
db.pizzaOrders.createIndex( { totalNumber: 1 } )

索引具有默认名称 orderDate_1 和 totalNumber_1。

添加查询设置

以下 setQuerySettings 示例添加了查询设置

db.adminCommand( {
   setQuerySettings: {
      find: "pizzaOrders",
      filter: {
         orderDate: { $gt: ISODate( "2024-01-20T00:00:00Z" ) }
      },
      sort: {
         totalNumber: 1
      },
      $db: "test"
   },
   settings: {
      indexHints: {
         ns: { db: "test", coll: "pizzaOrders" },
         allowedIndexes: [ "orderDate_1" ]
      },
      queryFramework: "classic"
   }
} )

返回查询设置

以下示例在聚合管道中使用一个 $querySettings 阶段来返回查询设置

db.aggregate( [ {
   $querySettings: { showDebugQueryShape: true }
} ] )

因为 showDebugQueryShape 设置为 true，所以 debugQueryShape 文档包含在输出中。您可以使用 queryShapeHash 标识符来定位查询设置。queryShapeHash 和 debugQueryShape 在此输出中突出显示

[
   {
      queryShapeHash: 'AB8ECADEE8F0EB0F447A30744EB4813AE7E0BFEF523B0870CA10FCBC87F5D8F1',
      settings: {
         indexHints: [
            {
               ns: { db: 'test', coll: 'pizzaOrders' },
               allowedIndexes: [ 'orderDate_1' ]
            }
         ],
         queryFramework: 'classic'
      },
      representativeQuery: {
         find: 'pizzaOrders',
         filter: { orderDate: { '$gt': ISODate('2023-01-20T00:00:00.000Z') } },
         sort: { totalNumber: 1 },
         '$db': 'test'
      },
      debugQueryShape: {
         cmdNs: { db: 'test', coll: 'pizzaOrders' },
         command: 'find',
         filter: { orderDate: { '$gt': '?date' } },
         sort: { totalNumber: 1 }
      }
   }
]

了解更多

$project

下一步

$queryStats