removeShardFromZone

Nesta página

Definição

Compatibilidade
Sintaxe
Comportamento
Exemplo

O MongoDB 5.0 é o fim da vida útil a partir de de 2024 outubro. Esta versão da documentação não é mais suportada. Para atualizar sua 5.0 implantação do, consulte o MongoDB 6.0 procedimentos de atualização.

Definição

removeShardFromZone: Novidade na versão 3.4.
O comando administrativo remove a associação entre um shard e removeShardFromZone uma zona.
Dica
Em mongosh, esse comando também pode ser executado por meio do método auxiliar sh.removeShardFromZone().
Os métodos auxiliares são práticos para os usuários mongosh, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a praticidade não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Compatibilidade

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 instâncias sem servidor. 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

Você só pode executar removeShardFromZone no banco de dados admin a partir de uma instância mongos .

O comando removeShardFromZone tem a seguinte sintaxe:

db.adminCommand(
   {
     removeShardFromZone: <string>,
     zone: <string>
   }
)

O comando utiliza os seguintes campos:

Campo	Tipo	Descrição
removeShardFromZone	string	O nome do shard do qual remover a associação de zona .
zona	string	O nome da zona cuja associação com o shard você deseja remover.

mongosh fornece o método auxiliar sh.removeShardFromZone().

Comportamento

removeShardFromZone não remove as faixas associadas à zona.

Para remover completamente uma zona do cluster, você deve executar removeShardFromZone em cada shard associado à zona.

Se o fragmento especificado for o último fragmento associado à zona, você deverá garantir que não haja intervalos de chave de fragmento restantes associados à zona. Use updateZoneKeyRange para remover quaisquer faixas existentes associadas à zona antes de executar removeShardFromZone.

Consulte a página do manual de zonas para obter mais informações sobre zonas em clusters fragmentados.

Segurança

Para clusters fragmentados que impõem controle de acesso, você deve autenticar como:

um usuário cujos privilégios incluem:
- update na collection shards no banco de dados config e
- find na collection tags no reconhecimento de data center config ;
ou, alternativamente
um usuário cujos privilégios incluem enableSharding no recurso do cluster .

As roles embutidas clusterAdmin ou clusterManager removeShardFromZone as permissões apropriadas para emitir . Consulte a página do manual Controle de acesso baseado em funções para obter mais informações.

Exemplo

O exemplo a seguir remove a associação entre shard0000 e a zona NYC:

db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )

Voltar

removeShard

reshardCollection