planCacheSetFilter

查询设置

从 MongoDB 8.0开始，使用查询设置而不是添加索引筛选器。 从 MongoDB 8.0开始，索引筛选器已弃用。

查询设置的功能比索引筛选器更多。 此外，索引筛选器不是持久性的，您无法轻松地为所有集群节点创建索引筛选器。 要添加查询设置并探索示例，请参阅setQuerySettings 。

在查询规划期间，查询优化器使用查询设置作为附加输入，这样会影响为运行查询而选择的计划。

这些设置将应用于整个集群上的查询结构。在关闭之后，集群将保留这些设置。

您可以为 find、distinct 和 aggregate 命令添加查询设置。

要删除查询设置，请使用 removeQuerySettings。要获取查询设置，请在一个聚合管道中使用一个 $querySettings 阶段。

对仅由谓词组成的计划缓存查询结构设置筛选器

以下示例在orders集合上创建了一个索引筛选器，这样对于仅包含status字段上的等值匹配而没有任何投影和排序的查询，查询优化器仅评估两个指定的索引，并且集合会扫描获胜计划：

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { status: "A" },
      indexes: [
         { cust_id: 1, status: 1 },
         { status: 1, order_date: -1 }
      ]
   }
)

在查询谓词中，只有谓词的结构（包括字段名称）重要；这些值无关紧要。 因此，创建的筛选器适用于以下操作：

db.orders.find( { status: "D" } )
db.orders.find( { status: "P" } )

要查看MongoDB是否会对计划缓存查询结构应用索引过滤，请检查indexFilterSet db.collection.explain()或cursor.explain() 方法的 字段。

对由谓词、投影和排序组成的计划缓存查询结构设置筛选器

以下示例为orderscollection创建了一个索引筛选器。该筛选器适用于其谓词为item字段的等值匹配的查询，其中仅投影quantity字段，并指定按order_date升序排序。

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { item: "ABC" },
      projection: { quantity: 1, _id: 0 },
      sort: { order_date: 1 },
      indexes: [
         { item: 1, order_date: 1 , quantity: 1 }
      ]
   }
)

对于计划缓存查询结构，查询优化器将仅考虑使用索引{ item: 1, order_date: 1, quantity: 1 }的索引计划。

对由谓词和排序规则组成的计划缓存查询结构设置筛选器

以下示例为orderscollection创建了一个索引筛选器。该筛选器适用于其谓词为item字段和排序规则en_US （美国英语）的等值匹配的查询。

db.runCommand(
   {
      planCacheSetFilter: "orders",
      query: { item: "Movie" },
      collation: { locale: "en_US" },
      indexes: [
         { item: 1, order_date: 1 , quantity: 1 }
      ]
   }
)

对于计划缓存查询结构，查询优化器仅使用使用索引{ item: 1, order_date: 1, quantity: 1 }的索引计划。

从 MongoDB6.0 开始，索引筛选器使用之前使用 命令设置的 排序规则 planCacheSetFilter。

从 MongoDB 8.0开始，使用查询设置而不是添加索引筛选器。 从 MongoDB 8.0开始，索引筛选器已弃用。

查询设置的功能比索引筛选器更多。 此外，索引筛选器不是持久性的，您无法轻松地为所有集群节点创建索引筛选器。 要添加查询设置并探索示例，请参阅setQuerySettings 。