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

limpezaOrganização

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Comportamento
  • Acesso necessário
  • Saída

Importante

A partir do MongoDB 6.0.3, você deve executar uma agregação usando o estágio $shardedDataDistribution para confirmar que nenhum documento órfão permanece. Para obter detalhes, consulte Confirmar que não há documentos órfãos restantes.

cleanupOrphaned

Use este comando para aguardar documentos órfãos em um intervalo de chunks do MinKey a seu MaxKey de uma chave de shard para que um namespace especificado seja limpo da maioria dos membros de um shard.

Para executar, emita cleanupOrphaned no banco de dados admin diretamente na instância mongod que é o principal membro do conjunto de réplicas do shard. Você não precisa desabilitar o balancer antes de executar cleanupOrphaned.

Observação

Não execute o cleanupOrphaned em uma instância do mongos .

Esse comando 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 comando tem a seguinte sintaxe:

db.runCommand(
{
cleanupOrphaned: "<database>.<collection>",
startingFromKey: <minimumShardKeyValue>, // deprecated
secondaryThrottle: <boolean>, // deprecated
writeConcern: <document> // deprecated
}
)

cleanupOrphaned tem os seguintes campos:

Campo
Tipo
Descrição

cleanupOrphaned

string

O namespace, ou seja, o reconhecimento de data center e o nome da collection, da collection fragmentada para a qual aguardar a limpeza dos dados órfãos.

O valor deste campo não é utilizado para determinar os limites do intervalo de limpeza. O comando cleanupOrphaned aguarda até que todos os documentos órfãos em todos os intervalos no namespace sejam limpos do fragmento antes de concluir, independentemente da presença ou do valor de startingFromKey.

Em sistemas executados com authorization, você deve ter clusterAdmin privilégios para executar cleanupOrphaned.

Cada comando cleanupOrphaned retorna um documento contendo um subconjunto dos seguintes campos:

cleanupOrphaned.ok

Igual a 1 em caso de sucesso.

Um valor de 1 indica que:

  • Nenhum documento órfão permanece no namespace cleanupOrphaned no fragmento, ou

  • A collection referenciada no namespace cleanupOrphaned não está fragmentada.

Um valor de 0 indica que ocorreu um erro.

Voltar

clearJumboFlag