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

sh.checkMetadataConsistency()

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Exemplo
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.

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

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.

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

Voltar

sh.balancerCollectionStatus