Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

sh.enableSharding()

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Comportamento
  • Exemplo

Definição

sh.enableSharding(database, primaryShard)

Observação

Alterado na versão 6.0.

A partir do MongoDB 6.0, esse método não é necessário para fragmentar uma collection.

Cria explicitamente um banco de dados. Utilize o método mongosh sh.shardCollection() para fragmentar collections no banco de dados. O método { mongosh sh.enableSharding() encapsula o comando enableSharding .

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando do banco de dados, consulte o comando enableSharding.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

Compatibilidade

Este método está disponível em sistemas hospedados nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem

Observação

Este comando não é suportado em instâncias sem servidor. Para obter mais informações, consulte Comandos não suportados.

Sintaxe

sh.enableSharding() tem o seguinte formato:

sh.enableSharding(
   <database>,
   <primary shard>  // Optional. Available starting in MongoDB 4.2.2 (and 4.0.14)
)

Parâmetro

O método sh.enableSharding() utiliza o seguinte parâmetro:

Parâmetro
Tipo
Descrição
Banco de dados
String

O nome do banco de dados que você deseja criar.

primaryShard
String

Opcional. O primary shard do banco de dados; o contém a collection não fragmentada desse banco de dados. Em geral, em vez de especificar explicitamente o primary shard, é recomendável deixar o balancer selecioná-lo.

Aviso

Dica

Em geral, não é necessário especificar o primary shard. Permita que o balancer selecione o primary shard.

Disponível a partir do MongoDB 4.2.2 (e 4.0.14)

Comportamento

Escreva preocupação

mongos utiliza "majority" para o comando enableSharding e seu auxiliar sh.enableSharding().

Primary shard

Em geral, não é preciso especificar o primaryShard no comando. Em vez disso, permita que o balancer selecione o primary shard.

No entanto, se você especificar o primary shard para um banco de dados e o banco de dados já estiver habilitado para a fragmentação com outro primary shard diferente, a operação retornará um erro, e o primary shard do banco de dados permanecerá como antes. Para alterar o primary shard de um banco de dados, utilize o comando movePrimary .

Exemplo

O exemplo a seguir, executado em um mongos, cria explicitamente o banco de dados shardTest:

sh.enableSharding("shardTest")

Para verificar, execute sh.status().

Dica

Veja também:

← sh.enableAutoSplit
sh.getBalancerState() →

Nesta página