addShard (comando de base de datos)

Definición

addShard: Agrega un set de réplicas de particiones a un clúster.
Tip
In mongosh, this command can also be run through the sh.addShard() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

Compatibilidad

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

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.

Nota

Este comando no es compatible con MongoDB Atlas. Consulte Modificar su clúster de Atlas para agregar o remover particiones de su clúster de Atlas.

Sintaxis

El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     addShard: "<replica_set>/<hostname><:port>",
     name: "<shard_name>"
   }
)

Campos de comandos

Nota

A partir de la 6.2 versión, MongoDB elimina el maxSize campo del comando. Como addShard resultado:

Running addShard with the maxSize field returns an InvalidOptions error.
Los nuevos documentos en la colección shards ya no incluyen el campo maxSize.
Se ignoran todas las entradas de campo maxSize preexistentes.

El comando contiene los siguientes campos:

Campo

Tipo

Descripción

addShard

string

El nombre del set de réplicas, el nombre de host y el puerto de al menos un nodo del set de réplicas de la partición. Cualquier nombre de host adicional de miembro del set de réplicas debe estar separado por comas. Por ejemplo:

<replica_set>/<hostname><:port>,<hostname><:port>, ...

name

string

opcional. Un nombre para la partición. Si esto no se especifica, MongoDB proporciona automáticamente un nombre único.

The addShard command stores shard configuration information in the config database. Always run addShard when using the admin database.

Considerations

Almacenamiento

La partición que agregues al clúster debe estar vacía.

Balanceo

Al añadir una partición a un clúster, se afecta el equilibrio de los fragmentos entre las particiones de un clúster para todas las colecciones particionadas existentes. El equilibrador comenzará a migrar fragmentos para lograr el equilibrio en el clúster. Consulta Balancer Internals para más información.

miembro oculto

Importante

You cannot include a hidden member in the seed list provided to addShard.

Operaciones de DDL

Si añades una partición mientras tu clúster ejecuta una operación DDL (operación que modifica una colección como reshardCollection), addShard solo se ejecuta después de que finalice la operación DDL concurrente.

Acceso requerido

Debes tener el addShard acción en un recurso de clúster para ejecutar el comando addShard. Los clusterAdmin o los clusterManager roles de funcionalidad incorporada contienen la acción addShard y otorgan privilegios para ejecutar el comando addShard.

Ejemplos

El siguiente comando añade un set de réplicas como partición:

use admin
db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )

Advertencia

No utilices localhost como nombre de host a menos que tu servidor de configuración también esté ejecutándose en localhost.

Volver

abortUnshardCollection

addShardToZone