PlanCache.clearPlansByQuery() (método mongosh)

Definición

PlanCache.clearPlansByQuery( <query>, <projection>, <sort> )

Borra los planes del query en caché para el especificado forma del query.

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.js.

Para el comando de base de datos, consulta el comando planCacheClear.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método solo está disponible desde el plan cache object de una colección específica; es decir.

db.collection.getPlanCache().clearPlansByQuery( <query>, <projection>, <sort> )

El método PlanCache.clearPlansByQuery() acepta los siguientes parámetros:

Parameter	Tipo	Descripción
query	Documento	El predicado de consulta de la forma del query. Solo la estructura del predicado, incluidos los nombres de los campos, es significativa para la forma; los valores en el predicado de consulta no son significativos.
projection	Documento	opcional. La proyección asociada con la forma del query. Obligatorio si se especifica el parámetro sort.
sort	Documento	opcional. La ordenación asociada con la forma del query.

Para ver las formas del query para las que existen planes del query en caché, consulta Ejemplos.

Acceso requerido

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

Ejemplo

Si una colección orders tiene la siguiente forma del query:

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

La siguiente operación remueve el plan del query almacenado en caché para la forma:

db.orders.getPlanCache().clearPlansByQuery(
   { "qty" : { "$gt" : 10 } },
   { },
   { "ord_date" : 1 }
)