Definición
sh.enableSharding(database, primaryShard)Habilita la fragmentación en la base de datos especificada. Una vez habilitada la fragmentación para una base de datos, puede usar
sh.shardCollection()para fragmentar colecciones en esa base de datos. Elmongoshmétodosh.enableSharding()encapsula elenableShardingcomando.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 M,0 M2 y5 M. 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 tiene la siguiente sh.enableSharding() forma:
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 la fragmentación. | |
String | Opcional. El fragmento principal de la base de datos; este fragmento contiene la colección no fragmentada de esta base de datos. En general, en lugar de especificar explícitamente el fragmento principal, se recomienda dejar que el balanceador lo seleccione. AdvertenciaTipEn general, no debería ser necesario especificar el fragmento principal. Permita que el balanceador lo seleccione. |
Comportamiento
Nivel de confirmación de escritura
mongos usa "majority" para el comando y enableSharding su sh.enableSharding() ayudante.
Fragmento primario
En general, no debería ser necesario especificar el fragmento principal en el comando. En su lugar, permita que el balanceador seleccione el fragmento principal.
Sin embargo, si especifica el fragmento principal de una base de datos y esta ya está habilitada para la fragmentación con un fragmento principal diferente, la operación devuelve un error y el fragmento principal permanece igual. Para cambiar el fragmento principal de una base de datos, utilice el movePrimary comando.
Ejemplo
El siguiente ejemplo, ejecutado desde un, habilita la fragmentación para mongos la test base de datos:
sh.enableSharding("test")
Para verificar,sh.status() ejecute.