Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Comandos de cache do plano de query

planCacheClear

Nesta página

  • Definição
  • Sintaxe
  • Campos de comando
  • Acesso necessário
  • Exemplos

Definição

planCacheClear

Remove planos de query em cache para uma collection. Especifique umaforma de query para remover planos de query em cache para essa forma. Omita a forma de query para limpar todos os planos de query em cache.

Dica

No mongosh, este comando também pode ser executado através dos métodos de ajuda PlanCache.clear() e PlanCache.clearPlansByQuery() .

Os métodos auxiliares são práticos para os usuários mongosh, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a praticidade não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
      planCacheClear: <collection>,
      query: <query>,
      sort: <sort>,
      projection: <projection>,
      comment: <any>
   }
)

Campos de comando

O comando usa os seguintes campos opcionais:

Campo
Tipo
Descrição
query
documento
Opcional. O predicado de query da forma de query. Somente a estrutura do predicado, incluindo os nomes dos campos, é significativa para a forma; os valores no predicado de query são insignificantes.
projection
documento
Opcional. A projeção associada à forma de query.
sort
documento
Opcional. A classificação associada à forma de query.
comment
qualquer

Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais:

Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).

Para ver as formas de consulta para as quais existem planos de consulta em cache, consulte Exemplos.

Acesso necessário

Em sistemas executados com authorization, um usuário deve ter acesso que inclua a ação planCacheWrite.

Exemplos

Limpar planos em cache para uma forma de query

Se uma collection orders tiver a seguinte forma de query:

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

A seguinte operação limpa o plano de query armazenado em cache para a forma:

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

Limpar todos os planos em cache de uma collection

O exemplo a seguir limpa todos os plano de query em cache para a collection orders :

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

Dica

Veja também:

Voltar

Comandos de cache do plano de query

Próximo

planCacheClearFilters

Nesta página