planCacheSetFilter (comando de base de datos)

Configuración de query

A partir de MongoDB 8.0, utiliza la configuración del query en lugar de añadir filtros de índice. Los filtros de índices están en desuso a partir de MongoDB 8.0.

La configuración de queries tiene más funcionalidades que los filtros de índices. Además, los filtros de índice no son persistentes y no puedes crear fácilmente filtros de índice para todos los nodos del clúster. Para añadir ajustes de query y explorar ejemplos, consulta setQuerySettings.

El optimizador de query utiliza la configuración del query como entrada adicional durante la planificación del query, lo que afecta al plan seleccionado para ejecutar el query.

Los ajustes se aplican a la forma de la query en todo el clúster. El clúster retiene la configuración después del apagado.

Puedes añadir configuraciones de query para los comandos find, distinct, y aggregate.

Para remover la configuración del query, utilice removeQuerySettings. Para obtener la configuración del query, utilice una etapa de $querySettings en una canalización de agregación.

Configuración de filtro en la forma del query de caché de plan que consta únicamente de un predicado

El siguiente ejemplo crea un filtro de índice en la colección orders de modo que, para las consultas que consisten únicamente en una coincidencia de igualdad en el campo status sin ninguna proyección ni ordenamiento, el optimizador de consultas evalúa únicamente los dos índices especificados y el escaneo de la colección para el plan ganador:

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

En el predicado de la query, solo la estructura del predicado, incluyendo los nombres de los campos, es significativa; los valores son insignificantes. Como tal, el filtro creado se aplica a las siguientes operaciones:

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

Para ver si MongoDB aplicará un filtro de índice para una forma de consulta de caché de plan, verifique el indexFilterSet campo del método db.collection.explain() cursor.explain() o.

Establecer filtro en la forma de consulta de caché del plan que consta de predicado, proyección y ordenación

El siguiente ejemplo crea un filtro de índice para la colección orders. El filtro se aplica a las consultas cuyo predicado es una coincidencia exacta en el campo item, donde solo se proyecta el campo quantity y se especifica una ordenación ascendente por el campo 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 }
      ]
   }
)

Para la forma del query de la caché del plan, el optimizador del query sólo considerará los planes indexados que utilicen el índice { item: 1, order_date: 1, quantity: 1 }.

Establezca el filtro en la forma del query de la caché de planes que consiste en el predicado y la intercalación

El siguiente ejemplo crea un filtro de índice para la colección orders. El filtro se aplica a queries cuyo predicado es una coincidencia exacta en el campo item y la intercalación en_US (inglés de Estados Unidos).

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

Para la forma del query de la caché de planes, el optimizador del query solo utiliza planes indexados que usan el índice { item: 1, order_date: 1, quantity: 1 }.

A partir de MongoDB 6.0, un filtro de índice utiliza la intercalación configurada previamente mediante el comando planCacheSetFilter.

A partir de MongoDB 8.0, utiliza la configuración del query en lugar de añadir filtros de índice. Los filtros de índices están en desuso a partir de MongoDB 8.0.

La configuración de queries tiene más funcionalidades que los filtros de índices. Además, los filtros de índice no son persistentes y no puedes crear fácilmente filtros de índice para todos los nodos del clúster. Para añadir ajustes de query y explorar ejemplos, consulta setQuerySettings.