Definición
sh.enableSharding(database, primaryShard)Habilita el particionado en la base de datos especificada. Una vez que se habilite el particionado en una base de datos, puede utilizar
sh.shardCollection()a las particiones de colecciones en esa base de datos. El métodomongoshsh.enableSharding()envuelve el comandoenableSharding.Importante
Método mongosh
Esta página documenta un método
mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.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, M2, y M5. Para obtener más información, consulte Comandos incompatibles.
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 el siguiente formulario:
sh.enableSharding( <database>, <primary shard> // Optional. )
Parameter
El método sh.enableSharding() toma los siguientes parámetros:
Parameter | Tipo | Descripción |
|---|---|---|
String | La base de datos para la que desea habilitar el particionado. | |
String | opcional. La partición primaria para la base de datos; la partición primaria contiene la colección no fragmentada para esta base de datos. En general, en lugar de especificar explícitamente la partición primaria, se recomienda dejar que el balanceador seleccione la partición primaria en su lugar. AdvertenciaTipEn general, no debería ser necesario especificar la partición primaria. Permitir que el balanceador seleccione la partición primaria en su lugar. |
Comportamiento
Nivel de confirmación de escritura
mongos utiliza "majority" para el comando enableSharding y su asistente 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.
Sin embargo, si especificas la partición primaria para una base de datos y la base de datos ya está habilitada para particionado con una partición primaria diferente, la operación devuelve un error y la partición primaria para la base de datos permanece como antes. Para cambiar la partición primaria de una base de datos, use el comando movePrimary en su lugar.
Ejemplo
El siguiente ejemplo, ejecutado desde un mongos, habilita particionado para la base de datos test:
sh.enableSharding("test")
Para verificar, ejecuta sh.status().