db.collection.checkMetadataConsistency()
Nesta página
Definição
db.collection.checkMetadataConsistency(options)
Executa uma série de verificações de consistência sobre a fragmentação de metadados para a collection. O 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 atualizações e downgrades, para verificar o estado do catálogo.
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.
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
Importante
Este comando não é suportado em clusters M0, M2 e M5 . Para obter mais informações, consulte Comandos não suportados.
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.collection.checkMetadataConsistency()
tem a seguinte sintaxe:
db.collection.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
db.authors.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") } } ], }