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.
Crea explícitamente una base de datos. Utilice el método mongosh sh.shardCollection() para fragmentar colecciones en la base de datos. El método mongosh sh.enableSharding() encapsula el comando enableSharding.
Importante
Método mongosh
Esta página documenta un método mongosh. No se trata de la documentación de comandos de base de datos ni de controladores específicos de lenguajes de programación, como 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 administrado 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, consulte 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

El sh.enableSharding() tiene la siguiente forma:

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

Parameter

El método sh.enableSharding() toma el siguiente parámetro:

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 utiliza "majority" para el comando enableSharding y su auxiliar sh.enableSharding().

partición primaria

En general, no debería ser necesario especificar el fragmento principal (primaryShard) en el comando. En su lugar, permita que el balanceador seleccione el fragmento principal.

Sin embargo, si especifica la partición principal de una base de datos y esta ya está habilitada para la fragmentación con una partición principal diferente, la operación devuelve un error y la partición principal de la base de datos permanece sin cambios. Para cambiar la partición principal de una base de datos, utilice el comando movePrimary.

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