enableSharding (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

enableSharding: Nota
Cambiado en la versión 6.0.
A partir de MongoDB,6.0 este comando no es necesario Fragmentar una colección.
El comando crea explícitamente una base de enableSharding datos.
Tip
mongoshEn, este comando también se puede ejecutar a través del método sh.enableSharding() auxiliar.
Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

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

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 comando tiene la siguiente sintaxis:

Recomendado. Especifique la base de datos que se creará:
```
db.adminCommand(
   {
     enableSharding: "<database name>"
   }
)
```
Opcionalmente, puede incluir la especificación del fragmento principal en el comando, aunque esto no se recomienda:
```
db.adminCommand(
   {
     enableSharding: "<database name>",
     primaryShard: "<shard name>"
   }
)
```

Solo puede ejecutar el comando en enableSharding la admin base de datos desde una mongos instancia.

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
habilitar fragmentación	String	La base de datos que desea utilizar. Si no existe, se crea.
fragmento primario	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. Advertencia Tip En general, no debería ser necesario especificar el fragmento principal. Permita que el balanceador lo seleccione.

Devuelve

El comando devuelve un documento que contiene el estado de la operación.

Comportamiento

Nivel de confirmación de escritura

mongos usa "majority" para el comando enableSharding y su asistente sh.enableSharding().

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 en el comando para una base de datos y esta ya tiene habilitada la fragmentación con un fragmento principal diferente, la operación devuelve un error y el fragmento principal de la base de datos permanece igual. Para cambiar el fragmento principal de una base de datos,movePrimary utilice.

Ejemplo

El siguiente comando, ejecutado desde un, crea mongos la shardTest base de datos:

db.adminCommand( { enableSharding: "shardTest" } )

Tip

Volver

configurarCollectionBalancing

vaciarRouterConfig