Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Operações de agregação
/
Referência
/
Estágios

$listSampledQueries

Nesta página

  • Definição
  • Sintaxe
  • Comportamento
  • Controle de acesso
  • Limitações
  • Exemplos
  • Listar amostras de query para todas as collection
  • Listar amostras de query para uma collection específica
  • Saída
  • Ler query
  • Escrever query

Definição

$listSampledQueries

Retorna query para todas as collection ou para uma collection específica. Exemplos de queries são utilizados pelo comando analyzeShardKey para calcular métricas sobre a distribuição de leitura e escrita de uma chave de shard.

Sintaxe

$listSampledQueries tem esta sintaxe:

{
   $listSampledQueries: { namespace: <namespace> }
}

Comportamento

  • Para listar query de amostra para uma única collection, especifique a collection no argumento namespace .

  • Para listar amostras de query para todas as collection, omita o argumento namespace .

Controle de acesso

$listSampledQueries requer a função clusterMonitor no cluster.

Limitações

  • Você não pode utilizar o $listSampledQueries em configuraçõesde multi-locatário do Atlas .

  • Você não pode utilizar o $listSampledQueries em sistemas autônomo.

  • Você não pode usar $listSampledQueries diretamente em um conjunto de réplicas --shardsvr . Ao executar em um cluster fragmentado, o $listSampledQueries deve ser executado em um mongos.

Exemplos

Listar amostras de query para todas as collection

A seguinte operação de aggregation lista todas as query de amostra para todas as collection no conjunto de réplicas:

db.aggregate( [  { $listSampledQueries: {  } } ] )

Listar amostras de query para uma collection específica

A seguinte operação de aggregation lista todas as query de amostra para uma collection post no reconhecimento de data center social :

db.aggregate( [  { $listSampledQueries: { namespace: "social.post" } } ] )

Saída

Os campo de saída são diferentes para query de leitura e escrita.

Ler query

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <find|aggregate|count|distinct>,
   cmd: {
     filter: <object>,
     collation: <object>,
     let: <object>
   },
   expireAt: <date>
}
Nome do campo
Tipo
Descrição
_id
UUID
ID de amostra para a query.
ns
string
namespace da collection amostrada.
collectionUuid
UUID
ID da collection amostrada.
cmdName
string

Nome do comando de amostra. Pode ser um dos seguintes:

  • "find"

  • "aggregate"

  • "count"

  • "distinct"

cmd.filter
objeto
Filtre com o qual o comando executou, se aplicável.
cmd.collation
objeto
Agrupamento com o qual o comando foi executado, se aplicável.
cmd.let
objeto
Variáveis personalizadas com as quais o comando foi executado, se aplicável.
expireAt
data
Data em que a amostra expira.

Escrever query

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <update|delete|findAndModify>,
   cmd: <object>,
   expireAt: <date>
}
Nome do campo
Tipo
Descrição
_id
UUID
ID de amostra para a query.
ns
string
namespace da collection amostrada.
collectionUuid
UUID
ID da collection amostrada.
cmdName
string

Nome do comando de amostra. Pode ser um dos seguintes:

  • "update"

  • "delete"

  • "findAndModify"

cmd
objeto
Objeto de comando
expireAt
data
Data em que a amostra expira.

Voltar

$listLocalSessions

Próximo

$listSearchIndexes

Nesta página