Definición
planCacheListFiltersLista los Filtros de índice asociados con formas de consulta para una colección.
Devuelve: Documento que enumera los filtros de índice. Ver salida.
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 M,0 M2 y5 M. Para obtener más información, consulte 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> } )
El comando planCacheListFilters tiene el siguiente campo:
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 acción planCacheIndexFilter.
Salida
El comando planCacheListFilters devuelve el documento con la siguiente forma:
{ "filters" : [ { "query" : <query> "sort" : <sort>, "projection" : <projection>, "indexes" : [ <index1>, ... ] }, ... ], "ok" : 1 }
planCacheListFilters.filtersEl arreglo de documentos que contienen la información del filtro de índice.
Cada documento contiene los siguientes campos:
planCacheListFilters.filters.queryEl predicado de query asociado con este filtro. Aunque el
querymuestra los valores específicos que se utilizan para crear el filtro de índices, los valores en el predicado no son significativos; es decir, los predicados de consulta abarcan consultas similares que solo difieren en los valores.Por ejemplo, una
querypredicado de{ "type": "electronics", "status" : "A" }cubre los siguientes predicados de query:{ type: "food", status: "A" } { type: "utensil", status: "D" } Junto con el
sorty elprojection, elquerycomponen la forma del query para el filtro de índice especificado.
planCacheListFilters.filters.sortLa ordenación asociada con este filtro. Puede ser un documento vacío.
Junto con el
queryy elprojection, elsortcomponen la forma del query para el filtro de índice especificado.
planCacheListFilters.filters.projectionLa proyección asociada con este filtro. Puede ser un documento vacío.
Junto con el
queryy elsort, elprojectioncomponen la forma del query para el filtro de índice especificado.
planCacheListFilters.filters.indexesEl arreglo de índices para esta forma del query. Para elegir el plan del query óptimo, el optimizador del query evalúa solamente los
indexeslistados y el escaneo de colección.