Definición
addShardAgrega un set de réplicas de partición a un clúster particionado.
Tip
En
mongosh, este comando también se puede ejecutar a través del método asistentesh.addShard().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 Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
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.
Sintaxis
El comando tiene la siguiente sintaxis:
{ addShard: "<replica_set>/<hostname><:port>", maxSize: <size>, name: "<shard_name>" }
Campos de comandos
El comando contiene los siguientes campos:
Campo | Tipo | Descripción | |
|---|---|---|---|
| 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: | |
| entero | opcional. El tamaño máximo en megabytes de la partición. Si configuras | |
| string | opcional. Un nombre para la partición. Si esto no se especifica, MongoDB proporciona automáticamente un nombre único. |
El comando addShard almacena la información de la configuración de particiones en la base de datos de configuración. Siempre ejecute addShard cuando use la base de datos admin.
Especifique un maxSize cuando tenga máquinas con diferentes capacidades de disco o si desea limitar la cantidad de datos en algunas particiones. La restricción maxSize impide que el balanceador migre fragmentos a la partición cuando el totalSize que se obtiene de ejecutar listDatabases en la partición supera el valor de maxSize.
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 addShard.
Ejemplos
El siguiente comando añade un set de réplicas como partición:
use admin db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )
Advertencia
No utilices localhost como nombre de host a menos que tu servidor de configuración también esté ejecutándose en localhost.