sh.addTagRange() (método mongosh)

Definición

sh.addTagRange(namespace, minimum, maximum, tag)

Nota

Este método es un alias de sh.updateZoneKeyRange(). MongoDB proporciona particionado de zona como el sucesor del particionado con reconocimiento de etiquetas.

Anexa un rango de valores de la clave de partición a una etiqueta de partición creada mediante el método sh.addShardTag().

Puede ejecutar el comando de base de datos updateZoneKeyRange y sus auxiliares sh.updateZoneKeyRange() y sh.addTagRange() en una colección no fragmentada o en una colección inexistente.

sh.addTagRange() toma los siguientes argumentos:

Parameter	Tipo	Descripción
`namespace`	string	El espacio de nombres de la colección particionada a etiquetar.
`minimum`	Documento	El valor mínimo del rango de clave de partición que se debe incluir en la etiqueta. El mínimo es una coincidencia inclusiva. Especifique el valor mínimo en la forma de `<fieldname>:<value>`. Este valor debe ser del mismo tipo BSON o tipos que la clave de partición.
`maximum`	Documento	El valor máximo del rango de clave de partición para incluir en la etiqueta. El máximo es una coincidencia exclusiva. Especifica el valor máximo en la forma de `<fieldname>:<value>`. Este valor debe ser del mismo tipo BSON o tipos que la clave de partición.
`tag`	string	El nombre de la etiqueta para adjuntar el rango especificado por los argumentos `minimum` y `maximum`.

Utiliza sh.addShardTag() para asegurarte de que el balanceador migre los documentos que existen dentro del rango especificado a una partición o conjunto de particiones específicos.

El problema sh.addTagRange() solo se presenta cuando se está conectado a una instancia mongos.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente administrado 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, consulte 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.

Comportamiento

Límites

Los rangos de zona siempre incluyen el límite inferior y excluyen el límite superior.

Distribución inicial de fragmentos para colecciones vacías o inexistentes

Si está considerando realizar una fragmentación por zonas en una colección vacía o inexistente, utilice sh.addTagRange() para crear las zonas y los rangos de zonas antes de fragmentar la colección. La creación de zonas y rangos de zonas en colecciones vacías o inexistentes permite a MongoDB optimizar el proceso inicial de creación y distribución de fragmentos al fragmentar la colección. Este proceso optimizado permite una configuración más rápida de la fragmentación por zonas con menor sobrecarga del balanceador que la creación de zonas después de la fragmentación.El balanceador gestiona todos los fragmentos tras la creación y distribución inicial optimizada de los mismos.

Para un ejemplo de cómo definir zonas y rangos de zonas para la distribución inicial de fragmentos, consulta Predefinir Zonas y Rangos de Zonas para una Colección Vacía o Inexistente.

Distribución inicial de fragmentos con claves de partición compuestas con hash

MongoDB ofrece soporte al particionado de colecciones en índices compuestos encriptados. MongoDB puede realizar una creación y distribución optimizadas de particiones iniciales al fragmentar la colección vacía o inexistente usando una clave de partición compuesta con hash.

Si el campo encriptada es el prefijo de la clave de partición (es decir, el primer campo en la clave de partición), todo lo siguiente debe ser cierto para que MongoDB realice la creación inicial y la distribución de fragmentos:

La colección tiene un único rango de zona con MinKey para todos los campos límite inferior y MaxKey para todos los campos límite superior.
sh.shardCollection() especifica la opción presplitHashedZones: true.

Si el campo encriptado no es el prefijo de la clave de partición (es decir, la clave de partición tiene uno o más campos iniciales no encriptados), deben cumplirse todas las siguientes condiciones para que MongoDB realice la creación y distribución inicial de fragmentos:

La colección tiene un rango de zona para cada combinación de valores de campo de prefijo distintos (es decir, todos los campos anteriores al campo encriptado).
Para el límite inferior de cada rango de zona, especifica MinKey para el campo encriptada y todos los campos posteriores.
Para cada rango de zona, al menos un campo de prefijo de límite superior debe diferir de su equivalente en el límite inferior.
sh.shardCollection() especifica la opción presplitHashedZones: true.

Para obtener un ejemplo más completo de la definición de zonas y rangos de zonas para la distribución inicial de fragmentos con unas claves de partición compuestas con hash, consulte Predefinición de zonas y rangos de zonas para una colección vacía o inexistente.

Colecciones descartadas

Al descartar una colección, se borran sus rangos de zona/etiqueta asociados.

En versiones anteriores, MongoDB no remueve las asociaciones de etiquetas de una colección descartada y, si luego creas una nueva colección con el mismo nombre, las asociaciones de etiquetas antiguas se aplicarán a la nueva colección.

Ejemplo

Dada una clave de partición de {state: 1, zip: 1}, la siguiente operación crea un rango de etiquetas que cubre los códigos postales del estado de Nueva York:

sh.addTagRange( "exampledb.collection",
                { state: "NY", zip: MinKey },
                { state: "NY", zip: MaxKey },
                "NY"
              )

Volver

sh.addShardToZone

sh.balancerCollectionStatus