Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

db.checkMetadataConsistency()

Nesta página

  • Definição
  • Sintaxe
  • Exemplo
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 do banco de dados, consulte o comando checkMetadataConsistency .

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

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 fornecido. Se for executado no 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.

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.

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")
}
}
],
}

Para executar verificações de consistência em um cluster, chame o db.checkMetadataConsistency() método admin :

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")
}
}
],
}

Voltar

convertShardKeyToHashed

Próximo

db.collection.checkMetadataConsistency()