Definición
planCacheListFiltersEnumera los filtros de índice asociados con formas de consulta de caché de plan para una colección.
Devuelve: Documento que enumera los filtros de índice. Ver Producción.
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.
Compatibilidad
Este comando está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
Importante
Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, consulta Comandos no compatibles.
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Sintaxis
El comando tiene la siguiente sintaxis:
db.runCommand( { planCacheListFilters: <collection> } )
Campos de comandos
El comando tiene los siguientes campos:
Campo | Tipo | Descripción |
|---|---|---|
| string | El nombre de la colección. |
| any | Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones:
Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.). |
Acceso requerido
Un usuario debe tener acceso que incluya la planCacheIndexFilter acción.
Salida
El comando planCacheListFilters devuelve el documento con la siguiente forma:
{ "filters" : [ { "query" : <query> "sort" : <sort>, "projection" : <projection>, "collation" : <collation>, "indexes" : [ <index1>, ... ] }, ... ], "ok" : 1 }
planCacheListFilters.filtersLa matriz de documentos que contienen la información del filtro de índice.
Cada documento contiene los siguientes campos:
planCacheListFilters.filters.queryEl predicado de consulta asociado a este filtro. Aunque muestra los valores específicos utilizados para crear el filtro de índice, los valores del predicado son insignificantes; es decir, los predicados de consulta abarcan consultas similares que difieren únicamente en los
queryvalores.Por ejemplo, un predicado
queryde{ "type": "electronics", "status" : "A" }cubre los siguientes predicados de consulta:{ type: "food", status: "A" } { type: "utensil", status: "D" }
planCacheListFilters.filters.projectionLa proyección asociada a este filtro. Puede ser un documento vacío.
planCacheListFilters.filters.collationLa intercalación asociada a este filtro. Puede ser un documento vacío.
planCacheListFilters.filters.indexesLa matriz de índices para la forma de consulta de caché del plan.
La forma de consulta de caché del plan es la combinación de estos campos:
Para elegir el mejor plan de consulta, el optimizador de consultas evalúa
indexesy el escaneo de colección.