/ /

particionado

Docs Home

Desarrollo

Comandos de base de datos

particionado

Docs Home

Desarrollo

Comandos de base de datos

particionado

addShard (comando de base de datos)

Definición

addShard: Agrega un conjunto de réplicas de fragmentos a un clúster fragmentado.
Tip
En mongosh, este comando también se puede ejecutar a través del método sh.addShard() 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 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 fragmentado de Atlas" para agregar o eliminar fragmentos 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:

Ejecutar addShard con el campo maxSize devuelve un error InvalidOptions.
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 conjunto de réplicas, el nombre de host y el puerto de al menos un miembro del conjunto de réplicas del fragmento. Los nombres de host adicionales de los miembros del conjunto de réplicas deben estar separados por comas. Por ejemplo:

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

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.

Considerations

Almacenamiento

El fragmento que agregue a su clúster fragmentado debe estar vacío.

Balanceo

Al añadir un fragmento a un clúster fragmentado, se modifica el equilibrio de fragmentos entre los fragmentos de un clúster para todas las colecciones fragmentadas existentes.El balanceador comenzará a migrar fragmentos para que el clúster alcance el equilibrio. Consulte "Funcionamiento interno del balanceador" para obtener más información.

Miembros ocultos

Importante

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

Operaciones de DDL

Si agrega un fragmento mientras su clúster ejecuta una operación DDL (operación que modifica una colección reshardCollection como), addShard solo se ejecuta después de que finalice la operación DDL simultánea.

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 utilice localhost como nombre de host a menos que su servidor de configuración también se esté ejecutando en localhost.

Volver

abortUnshardCollection

añadirFragmentoAZona