addShard (comando de base de datos)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Definición

addShard: Agrega un conjunto de réplicas de fragmentos a un clúster particionado.
Tip
En mongosh, este comando también se puede ejecutar a través del método asistente sh.addShard().
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 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>",
     maxSize: <size>,
     name: "<shard_name>"
   }
)

Campos de comandos

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>, ...

maxSize

entero

opcional. El tamaño máximo en megabytes de la partición. Si configuras maxSize en 0, MongoDB no limita el tamaño de la partición.

name

string

Opcional. Un nombre para el fragmento. Si no se especifica, MongoDB proporciona automáticamente un nombre único.

El addShard comando almacena la información de configuración del fragmento en addShard la admin base de datos de configuración. Ejecute siempre al usar la base de datos.

Especifique maxSize si tiene máquinas con diferentes capacidades de disco o si desea limitar la cantidad de datos en algunos fragmentos. La maxSize restricción impide que el balanceador migre fragmentos al fragmento cuando el valor totalSize devuelto tras ejecutar listDatabases en el fragmento supera el maxSize valor.

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.

Las migraciones de fragmentos pueden afectar el espacio en disco, ya que el fragmento de origen archiva automáticamente los documentos migrados de forma predeterminada. Para obtener más información,moveChunk consulte el directorio.

miembro oculto

Importante

No puede incluir un miembro oculto en la lista de semillas proporcionada addShard a.

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 agrega un conjunto de réplicas como un fragmento:

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

abortReshardCollection

addShardToZone