Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Fragmentação

removeShardFromZone

Nesta página

  • Definição
  • Sintaxe
  • Comportamento
  • Exemplo

Definição

removeShardFromZone

Novidade na versão 3.4.

O comando administrativo removeShardFromZone remove a associação entre um shard e umazona .

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.

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
string

O nome do shard do qual remover a associação de 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

Próximo

reshardCollection

Nesta página