sh.addShard() (método mongosh)

Definición

sh.addShard(<url>)

Agrega un conjunto de réplicas de fragmentos a un Clúster fragmentado. Este método debe ejecutarse en una mongos instancia.

Importante

Método mongosh

Esta página documenta a Método mongosh. Esta no es la documentación de comandos de base de datos ni de controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulta el comando addShard.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método sh.addShard() tiene el siguiente parámetro:

Parameter

Tipo

Descripción

host

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

El método tiene la siguiente forma de sh.addShard() prototipo:

sh.addShard("<replica_set>/<hostname><:port>")

Advertencia

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

mongos instalados desde los paquetes oficiales de Instalar MongoDB Community Edition en Debian y Instalar MongoDB Community Edition en Red Hat o CentOS tienen la configuración bind_ip establecida en 127.0.0.1 por defecto.

mongos utiliza "majority" para el comando addShard y su asistente sh.addShard().

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 M0 y Flex. Para obtener más información, consulta 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.

Considerations

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

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

Operaciones de DDL

Si ejecutas sh.addShard mientras tu clúster realiza una operación DDL (operación que modifica una colección como reshardCollection), sh.addShard solo se ejecuta después de que la operación DDL concurrente finaliza.

Ejemplo

Para agregar un fragmento, especifique el nombre del conjunto de réplicas y el nombre de host de al menos un miembro del conjunto, como semilla. Si especifica nombres de host adicionales, todos deben ser miembros del mismo conjunto de réplicas.

El siguiente ejemplo añade un set de réplicas llamado repl0 y especifica un nodo del set de réplicas:

sh.addShard("repl0/mongodb3.example.net:27327")

Volver

sh.abortUnshardCollection

Etiqueta de fragmento sh.addShardTag