sh.checkMetadataConsistency()
Definição
sh.checkMetadataConsistency(options)
Executa uma série de verificações de consistência sobre a fragmentação de metadados para o cluster. Esse método retorna um cursor com todos ou um lote dos resultados de inconsistência encontrados.
Importante
Método mongosh
Esta página documenta um método
mongosh
. Esta não é a documentação de comandos de banco de dados nem drivers específicos de linguagem, como Node.js.Para o comando de banco de dados de dados, consulte o comando
checkMetadataConsistency
.Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.
Execute este método após as principais operações de manutenção, como upgrades e downgrades, ou para verificar se os metadados do cluster são inconsistentes ou corrompidos devido a bugs em versões anteriores do MongoDB.
Por padrão, o método não verifica a consistência dos índices nos fragmentos. As verificações de índice podem retornar inconsistências falso positivo se forem executadas simultaneamente com operações que criam, excluem ou modificam índices. Para verificar índices com este método, defina a opção
checkIndexes
.Para obter mais informações sobre as inconsistências que esse método verifica, consulte Tipos de inconsistência.
Retorna: Este método retorna um cursor com uma array documents
, que contém um documento para cada inconsistência encontrada nos metadados de fragmentação.
Sintaxe
O método sh.checkMetadataConsistency()
tem a seguinte sintaxe:
sh.checkMetadataConsistency( { <options> } )
O documento options
pode utilizar os seguintes campos e valores:
Campo | Tipo | Descrição |
---|---|---|
checkIndexes | booleano | Define se o comando também verifica índices em metadados de fragmentação. Por padrão, essa operação está desabilitada, pois se ela puder retornar inconsistências de falsos positivos quando executada simultaneamente com operações que criam, excluem ou modificam índices. Verifique os índices apenas nos horários em que você souber que é improvável que essas operações ocorram. |
cursor | documento | Configura o cursor de retorno. |
cursor.batchSize | inteiro | Número máximo de documentos de inconsistência de metadados de fragmentação a serem incluídos em cada lote. |
Exemplo
sh.checkMetadataConsistency()
{ cursorHasMore: false, documents: [ { type: "MisplacedCollection", description: "Unsharded collection found on shard different from database primary shard", details: { namespace: "test.authors", shard: "shard02", localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4") } } ], }