Definición
planCacheClearElimina los planes de consulta almacenados en caché de una colección. Especifique un Planifique la forma deconsulta de caché para eliminar los planes de consulta almacenados en caché para esa forma. Omita la forma de consulta de caché 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 auxiliaresPlanCache.clear()PlanCache.clearPlansByQuery()y.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.
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( { planCacheClear: <collection>, query: <query>, sort: <sort>, projection: <projection>, comment: <any> } )
Campos de comandos
El comando toma los siguientes campos opcionales:
Campo | Tipo | Descripción |
|---|---|---|
| Documento | Opcional. El predicado de consulta de la forma de consulta de la caché del plan. Solo la estructura del predicado, incluidos los nombres de campo, es significativa para la forma; los valores del predicado de consulta son irrelevantes. |
| Documento | Opcional. La proyección asociada con la forma de consulta de caché del plan. |
| Documento | Opcional. La clasificación asociada con la forma de consulta de caché del plan. |
| 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.). |
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 de caché de plan
Si una colección orders tiene la siguiente forma de consulta de caché de plan:
{ "query" : { "qty" : { "$gt" : 10 } }, "sort" : { "ord_date" : 1 }, "projection" : { }, "planCacheShapeHash" : "9AAD95BE" }
Advertencia
A partir de MongoDB 8.0, el campo queryHash existente se duplica en un nuevo campo llamado planCacheShapeHash. Si estás utilizando una versión anterior de MongoDB, solo verás el campo queryHash. Las versiones futuras de MongoDB removerán el campo queryHash obsoleto y deberás utilizar el campo planCacheShapeHash en su lugar.
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" } )