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. Use o método
mongoshsh.shardCollection()para fragmentar coleções no banco de dados. O métodomongoshsh.enableSharding()encapsula o comandoenableSharding.Importante
Método mongosh
Esta página documenta um método.
mongoshEsta 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 do MongoDB específica da linguagem.
Compatibilidade
Esse método 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
Esse comando não é suportado em clusters M0 e Flex. 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
O tem o seguinte sh.enableSharding() formulário:
sh.enableSharding( <database>, <primary shard> // Optional. )
Parâmetro
O método utiliza o seguinte sh.enableSharding() parâmetro:
Parâmetro | Tipo | Descrição |
|---|---|---|
String | O nome do banco de dados que você deseja criar. | |
String | Opcional. O fragmento primário do banco de banco de dados. É o fragmento padrão para todas as coleções não fragmentadas no banco de banco de dados. AVISO: em geral, você não deve especificar o fragmento primário. Permita que o cluster selecione o fragmento primário . |
Comportamento
Escreva preocupação
mongos utiliza "majority" para o comando e enableSharding seu sh.enableSharding() assistente.
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 fragmento primário para um banco de dados e o banco de dados já estiver habilitado para a fragmentação com outro fragmento primário diferente, a operação retornará um erro, e o fragmento primário do banco de dados permanecerá como antes. Para alterar o fragmento primário de um banco de dados, use o movePrimary comando.
Exemplo
O exemplo a seguir, executado em um mongos, cria explicitamente o banco de dados shardTest:
sh.enableSharding("shardTest")
Para verificar, execute sh.status().