Definición
addShardToZoneAsocia un fragmento con un Zona. MongoDB asocia este fragmento con la zona dada. Los fragmentos que abarca la zona se asignan a los fragmentos asociados a ella.
Tip
mongoshEn, este comando también se puede ejecutar a través del métodosh.addShardToZone()auxiliar.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.
Solo puede ejecutar en addShardToZone la admin base de datos desde una mongos instancia.
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:
db.adminCommand( { addShardToZone: <string>, zone: <string> } )
Campos de comandos
El comando toma los siguientes campos:
Campo | Tipo | Descripción |
|---|---|---|
string | El nombre del fragmento que se asociará con la zona. | |
string | El nombre de la zona que se asociará con el fragmento. |
mongosh proporciona el método sh.addShardToZone() auxiliar.
Comportamiento
Puede asociar una zona con varios fragmentos, y un fragmento puede asociarse con varias zonas.
Consulte la página del manual de zonas para obtener más información sobre las zonas en un clúster fragmentado.
Gamas
MongoDB ignora efectivamente las zonas que no tienen al menos un rango de valores de clave de fragmento asociados a ellas.
Para asociar un rango de valores de clave de fragmento con una zona, utilice el updateZoneKeyRange comando de base de datos o el ayudante sh.updateZoneKeyRange() de shell.
Puede ejecutar el comando de base de datosupdateZoneKeyRangey sus ayudantessh.updateZoneKeyRange()ysh.addTagRange()en una colección no fragmentada o en una colección inexistente.
Tip
Al definir las zonas y sus rangos antes de fragmentar una colección vacía o inexistente, la operación de recopilación de fragmentos crea fragmentos para los rangos de zona definidos, así como fragmentos adicionales para cubrir todo el rango de valores de clave de fragmento, y realiza una distribución inicial de fragmentos basada en los rangos de zona. Esta creación y distribución inicial de fragmentos permite una configuración más rápida de la fragmentación por zonas. Tras la distribución inicial, el balanceador gestiona la distribución de fragmentos en adelante.
Consulte Zonas predefinidas y rangos de zonas para una colección vacía o inexistente para ver un ejemplo.
Seguridad
Para los clústeres fragmentados que aplican el control de acceso, debe autenticarse como un usuario cuyos privilegios incluyan:
updateen lashardscolección en laconfigbase de datos; o, alternativamente,enableShardingen el recurso del clúster.
Los roles clusterAdmin integrados o clusterManager tienen los permisos adecuados para addShardToZone emitir. Consulte la página de documentación sobre el control de acceso basado en roles para obtener más información.
Ejemplo
El siguiente ejemplo asocia shard0000 con la zona JFK:
db.adminCommand( { addShardToZone : "shard0000" , zone : "JFK" } )
Una partición puede asociarse a varias zonas. El siguiente ejemplo asocia LGA a shard0000:
db.adminCommand( { addShardToZone : "shard0000" , zone : "LGA" } )
shard0000 Se asocia con las zonas LGA y JFK. En un clúster equilibrado, MongoDB enruta las lecturas y escrituras cubiertas por cualquiera de las zonas a shard0000.