planCacheClear (comando de base de datos)

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

Definición

planCacheClear: Elimina los planes de consulta almacenados en caché de una colección. Especifique un Consultarforma para eliminar los planes de consulta almacenados en caché para esa forma. Omitir la consulta para borrar todos los planes de consulta almacenados en caché.
Tip
En mongosh, este comando también se puede ejecutar a través de los métodos asistentes PlanCache.clear() y PlanCache.clearPlansByQuery().
Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

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

Campos de comandos

El comando toma los siguientes campos opcionales:

Campo	Tipo	Descripción
`query`	Documento	Opcional. El predicado de consulta de la forma de consulta. Solo la estructura del predicado, incluidos los nombres de campo, es significativa para la forma; los valores del predicado de consulta son irrelevantes.
`projection`	Documento	Opcional. La proyección asociada con la forma de la consulta.
`sort`	Documento	Opcional. El tipo asociado con la forma de consulta.
`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.).

Para ver las formas de consulta para las que existen planes de consulta almacenados en caché, consulte Ejemplos.

Acceso requerido

En los sistemas que se ejecutan con, un usuario debe authorization planCacheWrite tener acceso que incluya la acción.

Ejemplos

Borrar planes almacenados en caché para una forma de consulta

Si una colección orders tiene la siguiente forma de consulta:

{
  "query" : { "qty" : { "$gt" : 10 } },
  "sort" : { "ord_date" : 1 },
  "projection" : { },
  "queryHash" : "9AAD95BE"
}

La siguiente operación borra el plan de consulta almacenado en caché para la forma:

db.runCommand(
   {
      planCacheClear: "orders",
      query: { "qty" : { "$gt" : 10 } },
      sort: { "ord_date" : 1 }
   }
)

Borrar todos los planes almacenados en caché de una colección

El siguiente ejemplo borra todos los planes de consulta almacenados en caché para la colección orders:

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

Tip

Volver

Caché del plan del query

planCacheClearFilters