sh.enableSharding() (método de mongosh)

Definición

sh.enableSharding(database, primaryShard): Nota
Cambiado en la versión 6.0.
A partir de MongoDB 6.0, no se requiere este método para partición una colección.
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 el comando de base de datos, consulta el comando enableSharding.
Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Importante

Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, consulta Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

The sh.enableSharding() has the following form:

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

Parameter

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

Parameter	Tipo	Descripción
database	String	El nombre de la base de datos que desea crear.
partición primaria	String	opcional. El partición primaria de la base de datos. Es el shard por defecto para todas las colecciones no particionadas de la base de datos. ADVERTENCIA: En general, no se debe especificar la partición primaria. Permitir que el clúster seleccione la partición primaria en su lugar.

Comportamiento

Nivel de confirmación de escritura

mongos uses "majority" for the enableSharding command and its helper sh.enableSharding().

partición primaria

En general, no deberías necesitar especificar el primaryShard en el comando. En su lugar, permite que el balanceador seleccione la partición primaria.

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.

Ejemplo

El siguiente ejemplo, ejecutado desde un mongos, crea explícitamente la base de datos shardTest:

sh.enableSharding("shardTest")

Para verificar, ejecuta sh.status().

Tip

Volver

sh.enableMigrations

sh.getBalancerState