Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
addShard
Nesta página
Definição
addShard
Adiciona um conjunto de réplicas de fragmento a um cluster fragmentado.
Dica
Em
mongosh
, este comando também pode ser executado por meio do método auxiliarsh.addShard()
.Os métodos auxiliares são convenientes 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 conveniência não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.Execute o
addShard
quando conectado a uma instância domongos
. O comando usa o seguinte formulário para adicionar um conjunto de réplicas de shard:{ addShard: "<replica_set>/<hostname><:port>", maxSize: <size>, name: "<shard_name>" } O comando contém os seguintes campos:
CampoTipoDescriçãoaddShard
stringO nome do conjunto de réplicas, nome do host e porta de pelo menos um membro do conjunto de réplicas do shard. Quaisquer nomes de host do membro do conjunto de réplicas adicionais devem ser separados por vírgula. Por exemplo:
<replica_set>/<hostname><:port>,<hostname><:port>, ... maxSize
inteiroOpcional. O tamanho máximo em megabytes do shard. Se você definirmaxSize
como0
, o MongoDB não limitará o tamanho do shard.name
stringOpcional. Um nome para o fragmento. Se isso não for especificado, o MongoDB fornecerá automaticamente um nome exclusivo.O comando
addShard
armazena informações de configuração de shard no banco de dados de configuração. Sempre executeaddShard
ao utilizar o banco de dados doadmin
.Especifique um
maxSize
quando você tiver máquinas com capacidades de disco diferentes ou se você quiser limitar a quantidade de dados em alguns fragmentos. A restriçãomaxSize
impede que o balanceador migre parte para o fragmento quando ototalSize
retornado da execução delistDatabases
no fragmento excede o valor demaxSize
.
Considerações
Equilíbrio
Quando você adiciona um shard a um cluster fragmentado, afeta o equilíbrio de parte entre os shards de um cluster para todas as collection fragmentadas existentes. O balancer começará a migrar blocos para que o cluster atinja o equilíbrio. Consulte balanceador de Cluster para obter mais informações.
As migrações de chunks podem ter um impacto no espaço em disco, pois o shard de origem arquiva automaticamente os documentos migrados por padrão. Para detalhes, consulte o diretório moveChunk
.
membro oculto
Importante
Você não pode incluir um membro oculto na lista de sementes fornecida para addShard
.
Exemplos
O seguinte comando adiciona um conjunto de réplicas como um fragmento:
use admin db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )
Aviso
Não use localhost
para o nome do host, a menos que seu servidor de configuração também esteja sendo executado em localhost
.