db.collection.explain()

Modos de Verbosidade

O comportamento de db.collection.explain() e a quantidade de informações retornadas dependem do modo verbosity.

Operações de explicação e gravação

Para operações de gravação, db.collection.explain() retorna informações sobre a operação de gravação que seria executada, mas na verdade não modifica o banco de dados.

Restrições

Você não pode executar o comando explain /db.collection.explain() no modo executionStats ou allPlansExecution para um aggregation pipeline que contém o estágio $out. Em vez disso, você pode:

• executar a explicação no modo queryPlanner ou

• executar a explicação no modo executionStats ou no modo allPlansExecution, mas sem o estágio $out para retornar informações para os estágios que precedem o estágio $out.

explain() Mecânica

O método db.collection.explain() envolve o comando explain e é o caminho preferencial para executar explain.

db.collection.explain().find() é semelhante a db.collection.find().explain() com as seguintes diferenças principais:

• A construção db.collection.explain().find() permite o encadeamento adicional de modificadores de query. Para ver a lista de modificadores de query, consulte db.collection.explain().find().help().

• O db.collection.find().explain() retorna um cursor, o que exige uma chamada a .next(), ou seu alias .finish(), para retornar os resultados explain(). Se executado de forma interativa em mongosh, mongosh chama automaticamente .finish() para retornar os resultados. No entanto, para scripts, você deve chamar explicitamente .next() ou .finish() para retornar os resultados. Para ver a lista de métodos relacionados ao cursor, consulte db.collection.explain().find().help()..

db.collection.explain().aggregate() é equivalente a passar a opção de explicação para o método db.collection.aggregate().

help()

Para visualizar a lista de operações suportadas pelo db.collection.explain(), execute:

db.collection.explain().help()

db.collection.explain().find() retorna um cursor, que permite a cadeia de modificadores de query. Para ver a lista de modificadores de consulta suportados por db.collection.explain().find(), bem como os métodos relacionados ao cursor, execute:

db.collection.explain().find().help()

Você pode encadear vários modificadores para db.collection.explain().find(). Para ver um exemplo, consulte Explicar find() com modificadores.

queryPlanner Modo

Por padrão, db.collection.explain() é executado no modo de detalhamento "queryPlanner".

O exemplo a seguir é executado db.collection.explain() no modo de detalhamento "queryPlanner" para retornar as informações de planejamento de consulta para a operação de count() especificada:

db.products.explain().count( { quantity: { $gt: 50 } } )

executionStats Modo

O exemplo a seguir executa db.collection.explain() no modo de detalhamento "executionStats" para retornar as informações de planejamento e execução da query para a operação de find() especificada:

db.products.explain("executionStats").find(
   { quantity: { $gt: 50 }, category: "apparel" }
)

allPlansExecution Modo

O exemplo a seguir executa db.collection.explain() no modo de verbosidade "allPlansExecution". db.collection.explain() retorna queryPlanner e executionStats para todos os planos considerados para a operação findAndModify() especificada:

db.products.explain( "allPlansExecution" ).findAndModify( {
   query: { name: "Tom", state: "active", rating: { $gt: 10 } },
   sort: { rating: 1 },
   update: { $inc: { score: 1 } }
} )

Explique find() com modificadores

A construção db.collection.explain().find() permite o encadeamento de modificadores de query. Por exemplo, a operação a seguir fornece informações sobre o método find() com modificadores de query sort() e hint().

db.products.explain("executionStats").find(
   { quantity: { $gt: 50 }, category: "apparel" }
).sort( { quantity: -1 } ).hint( { category: 1, quantity: -1 } )

Para uma lista de modificadores de query disponíveis, execute o seguinte em mongosh:

db.collection.explain().find().help()

Iterar o explain().find() cursor de retorno

db.collection.explain().find() retorna um cursor para os resultados de explicação. Se executado de forma interativa no mongosh, mongosh itera automaticamente o cursor utilizando o método .next(). No entanto, para scripts, você deve chamar explicitamente .next() (ou seu nome alternativo .finish()) para retornar os resultados:

var explainResult = db.products.explain().find( { category: "apparel" } ).next();