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
mongosinstancia.Importante
Método mongosh
Esta página documenta un método
mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.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:ParameterTipoDescripciónhoststring
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>, ... El método tiene la siguiente forma de
sh.addShard()prototipo:sh.addShard("<replica_set>/<hostname><:port>") Advertencia
No utilice
localhostcomo nombre de host a menos que su servidor de configuración también se esté ejecutando enlocalhost.mongosinstalados desde los paquetes oficiales de Instalar MongoDB Community Edition en Debian y Instalar MongoDB Community Edition en Red Hat o CentOS tienen la configuraciónbind_ipestablecida en127.0.0.1por defecto.mongosusa"majority"para el comando yaddShardsush.addShard()ayudante.
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 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.
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.
Miembros ocultos
Importante
No puede incluir un miembro oculto en la lista de semillas proporcionada sh.addShard() a.
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 agrega un conjunto de réplicas llamado repl0 y especifica un miembro del conjunto de réplicas:
sh.addShard("repl0/mongodb3.example.net:27327")