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
mongoshsh.shardCollection()para fragmentar colecciones en la base de datos. El métodomongoshsh.enableSharding()envuelve el comandoenableSharding.Importante
Método mongosh
Esta página documenta un método.
mongoshEsta no es la documentación para comandos de base de datos ni controladores específicos de lenguaje, 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 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
El tiene la siguiente sh.enableSharding() forma:
sh.enableSharding( <database>, <primary shard> // Optional. )
Parameter
El método toma el siguiente sh.enableSharding() parámetro:
Parameter | Tipo | Descripción |
|---|---|---|
String | El nombre de la base de datos que desea crear. | |
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 y enableSharding su sh.enableSharding() auxiliar.
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 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 movePrimary comando.
Ejemplo
El siguiente ejemplo, ejecutado desde un mongos, crea explícitamente la base de datos shardTest:
sh.enableSharding("shardTest")
Para verificar, ejecuta sh.status().