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 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 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
mongosutiliza"majority"para el comandoaddShardy su asistentesh.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, M2, y M5. Para obtener más información, consulte Comandos incompatibles.
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 agregar una partición a un clúster particionado, se afecta el equilibrio de los fragmentos entre las particiones de un clúster para todas las colecciones particionadas existentes. El balanceador comenzará a migrar fragmentos para lograr el equilibrio en el clúster. Consulta Clúster Balanceador para obtener más información.
Las migraciones de fragmentos pueden afectar el espacio en disco, ya que la partición fuente archiva automáticamente los documentos migrados por defecto. Para más detalles, consulte el directoriomoveChunk.
miembro oculto
Importante
No se puede incluir un miembro oculto en la lista de nodos iniciales proporcionada en sh.addShard().
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")