sh.addShard() (método mongosh)

Definición

sh.addShard(<url>)

Agrega un set de réplicas de partición a un clúster particionado. Este método debe ejecutarse en una instancia de mongos.

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 sh.addShard() tiene la siguiente forma de 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 se puede incluir un miembro oculto en la lista de nodos iniciales proporcionada en sh.addShard().

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 añadir una partición, especifica el nombre del set de réplicas y el nombre del host de al menos un nodo del set de réplicas, como semilla. Si especifica nombres de host adicionales, todos deben ser nodos del mismo set 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

sh.addShardTag