db.checkMetadataConsistency()
Nesta página
Definição
db.checkMetadataConsistency(options)
Executa uma série de verificações de consistência sobre a fragmentação de metadados para o cluster ou reconhecimento de data center. 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
.Por padrão, o método verifica a fragmentação de metadados para o banco de dados de dados fornecido. Se for executado no banco de banco de dados
admin
, ele verificará a fragmentação de metadados para todo o cluster.Para obter mais informações sobre as inconsistências que esse método procura, 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.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Observação
Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas para todos os comandos, consulte Comandos sem suporte.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Sintaxe
O método db.checkMetadataConsistency()
tem a seguinte sintaxe:
db.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
Executar uma verificação de consistência no banco de dados
Para executar verificações de consistência em um banco de dados, chame o método db.checkMetadataConsistency()
:
use library db.checkMetadataConsistency()
{ cursorHasMore: false, documents: [ { type: "MisplacedCollection", description: "Unsharded collection found on shard different from database primary shard", details: { namespace: "library.authors", shard: "shard02", localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4") } } ], }
Realizar verificações de consistência no cluster
Para executar verificações de consistência em um cluster, chame o db.checkMetadataConsistency()
método no admin
banco de dados de dados :
use admin db.checkMetadataConsistency()
{ cursorHasMore: false, documents: [ { type: "MisplacedCollection", description: "Unsharded collection found on shard different from database primary shard", details: { namespace: "library.authors", shard: "shard02", localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4") } } ], }