planCacheClearFilters

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 5.0, consulte Procedimientos de actualización de MongoDB.6.0

Definición

planCacheClearFilters

Elimina Filtros de índice en una colección. Aunque los filtros de índice solo existen mientras dura el proceso del servidor y no persisten tras el apagado, también puede borrarlos con el planCacheClearFilters comando.

Especifique la forma de la consulta para eliminar un filtro de índice específico. Omítala para borrar todos los filtros de índice de una colección.

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(
   {
      planCacheClearFilters: <collection>,
      query: <query pattern>,
      sort: <sort specification>,
      projection: <projection specification>,
      comment: <any>
   }
)

El comando tiene el siguiente planCacheClearFilters campo:

Campo	Tipo	Descripción
`planCacheClearFilters`	string	El nombre de la colección.
`query`	Documento	Opcional. El predicado de consulta asociado al filtro que se eliminará. Si se omite, borra todos los filtros de la colección. Los valores en el `query` predicado son insignificantes para determinar la forma de la consulta, por lo que los valores utilizados en la consulta no necesitan coincidir con los valores que se muestran `planCacheListFilters` utilizando.
`sort`	Documento	Opcional. El tipo asociado con el filtro a eliminar, si lo hay.
`projection`	Documento	Opcional. La proyección asociada al filtro a eliminar, si lo hay.
`comment`	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: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. 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.

Ejemplos

Borrar el filtro de índice específico de la colección

La colección orders contiene los dos filtros siguientes:

{
  "query" : { "status" : "A" },
  "sort" : { "ord_date" : -1 },
  "projection" : { },
  "indexes" : [ { "status" : 1, "cust_id" : 1 } ]
}
{
  "query" : { "status" : "A" },
  "sort" : { },
  "projection" : { },
  "indexes" : [ { "status" : 1, "cust_id" : 1 } ]
}

El siguiente comando elimina únicamente el segundo filtro de índice:

db.runCommand(
   {
      planCacheClearFilters: "orders",
      query: { "status" : "A" }
   }
)

Dado que los valores del query predicado son insignificantes para determinar la forma de la consulta, el siguiente comando también eliminaría el segundo filtro de índice:

db.runCommand(
   {
      planCacheClearFilters: "orders",
      query: { "status" : "P" }
   }
)

Borrar todos los filtros de índice de una colección

El siguiente ejemplo borra todos los filtros de índice en la colección orders:

db.runCommand(
   {
      planCacheClearFilters: "orders"
   }
)

Tip

Volver

planCacheClear

Filtros de lista de caché de planificación