sh.addShardTag() (método mongosh)

Definición

sh.addShardTag(shard, tag)

Nota

Este método tiene un alias para sh.addShardToZone(). MongoDB proporciona fragmentación de zonas como sucesora de la fragmentación basada en etiquetas.

Asocia un fragmento con una etiqueta o identificador. MongoDB usa estos identificadores para dirigir los fragmentos que se encuentran dentro de un rango etiquetado a fragmentos específicos. sh.addTagRange() asocia rangos de fragmentos con rangos de etiquetas.

Parameter	Tipo	Descripción
shard	string	El nombre del fragmento al que se le dará una etiqueta específica.
tag	string	El nombre de la etiqueta que se agregará al fragmento.

Solo emite sh.addShardTag() cuando estés conectado a una instancia mongos.

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.

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

• 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.

Ejemplo

El siguiente ejemplo agrega tres etiquetas, NYC, LAX y NRT, a tres fragmentos:

sh.addShardTag("shard0000", "NYC")
sh.addShardTag("shard0001", "LAX")
sh.addShardTag("shard0002", "NRT")