db.collection.analyzeShardKey()

Nesta página

Definição

Sintaxe
Campos
Comportamento
Controle de acesso
Saída
Exemplos
Saiba mais

Definição

db.collection.analyzeShardKey(key, opts): Calcula métricas para avaliar uma chave de fragmento para uma coleção fragmentada ou não fragmentada. As métricas são baseadas em queries de amostra. Você pode utilizar o configureQueryAnalyzer para configurar a amostragem de query em uma collection.

Sintaxe

db.collection.analyzeShardKey() tem esta sintaxe:

db.collection.analyzeShardKey(
   <shardKey>,
   {
     keyCharacteristics: <bool>,
     readWriteDistribution: <bool>,
     sampleRate: <double>,
     sampleSize: <int>
   }
 )

Campos

Campo	Tipo	necessidade	Descrição
`key`	documento	Obrigatório	Chave de shard para analisar. Pode ser uma chave de shard candidata a uma collection não fragmentada ou uma collection fragmentada, ou a chave de shard atual para uma collection fragmentada. Não há valor padrão.
`opts.keyCharacteristics`	booleano	Opcional	Se as métricas sobre as características da chave de shard são calculadas ou não. Para obter detalhes, consulte keyChaacteristics. Padrão é `true`.
`opts.readWriteDistribution`	booleano	Opcional	Se as métricas sobre a distribuição de leitura e escrita são ou não calculadas. Para obter detalhes, consulte readWriteDistribution. Padrão é `true`.
`opts.sampleRate`	em dobro	Opcional	A proporção dos documentos na collection a serem amostradas ao calcular as métricas sobre as características da chave de shard. Se você definir `sampleRate`, não poderá definir `sampleSize`. Deve ser maior que `0`, até e inclusive `1`. Não há valor padrão.
`opts.sampleSize`	inteiro	Opcional	O número de documentos a serem amostrados ao calcular as métricas sobre as características da chave de shard. Se você definir `sampleSize`, não poderá definir `sampleRate`. Se não for especificado e `sampleRate` não for especificado, o tamanho da amostra assumirá como padrão o tamanho da amostra definido por `analyzeShardKeyCharacteristicsDefaultSampleSize`.

Comportamento

Para comportamento, consulte analyzeShardKey Comportamento.

Controle de acesso

Para obter detalhes, consulte o Controle de acesso analyzeShardKey.

Saída

Para obter saída de amostra, consulte Saída analyzeShardKey.

Exemplos

Por exemplo, consulte Exemplos de analyzeShardKey.

Saiba mais

← Métodos de collection

db.collection.aggregate() →