sh.enableSharding() (método mongosh)

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.
Explicitly creates a database. Use the mongosh method sh.shardCollection() to shard collections on the database. The mongosh method sh.enableSharding() wraps the enableSharding command.
Importante
Método mongosh
This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as 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: The fully managed service for MongoDB deployments in the cloud

Importante

This command is not supported in M0 and Flex clusters. For more information, see Unsupported Commands.

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

The sh.enableSharding() has the following form:

sh.enableSharding(
   <database>,
   <primary shard>  // Optional.
)

Parâmetro

The sh.enableSharding() method takes the following parameter:

Parâmetro	Tipo	Descrição
database	String	O nome do banco de dados que você deseja criar.
primaryShard	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 uses "majority" for the enableSharding command and its helper sh.enableSharding().

Primary shard

In general, you should not need to specify the primaryShard in the command. Instead, allow the balancer to select the primary shard.

However, if you do specify the primary shard for a database and the database is already enabled for sharding with a different primary shard, the operation returns an error and the primary shard for the database remains as before. To change the primary shard for a database, use the movePrimary command instead.

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

Voltar

sh.enableMigrations

sh.getBalancerState