addShardToZone (comando de base de datos)

Definición

addShardToZone: Asocia una partición con una zona. MongoDB asocia esta partición con la zona dada. Los fragmentos que están cubiertos por la zona se asignan a particiones asociadas con la zona.
Tip
mongoshEn, este comando también se puede ejecutar a través del método sh.addShardToZone() auxiliar.
Los métodos auxiliares son convenientes para mongosh los usuarios de, pero es posible que no devuelvan el mismo nivel de información que los comandos de la base de datos. En los casos en que no se necesite la conveniencia o se requieran los campos de retorno adicionales, utilice el comando de la base de datos.

Solo puedes 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
addShardtoZone	string	El nombre del fragmento que se asociará con la zona.
zona	string	El nombre de la zona que se asociará con el fragmento.

mongosh proporciona el método sh.addShardToZone() auxiliar.

Comportamiento

Puedes asociar una zona con múltiples particiones y una partición puede estar asociada con múltiples zonas.

Consulta la página de manual de zonas para obtener más información sobre zonas en un clúster fragmentado.

rango

MongoDB ignora de manera efectiva las zonas que no tienen al menos un rango de valores de la clave de partición asociado con ellas.

Para asociar un rango de valores de la clave de partición con una zona, utiliza el comando de base de datos updateZoneKeyRange o el asistente de shell sh.updateZoneKeyRange().

Puede ejecutar el updateZoneKeyRange comando de base de datos y sus asistentes sh.updateZoneKeyRange() y sh.addTagRange() en una colección no particionada o en una colección que no existe.

Tip

Al definir las zonas y los rangos de zonas antes de fragmentar una colección vacía o inexistente, la operación de "shard colletion" crea fragmentos para la zona definida rangos así como cualquier fragmento adicional para cubrir todo el rango de los valores de la clave de partición y realiza una distribución inicial de fragmentos basada en los rangos de zonas. Esta creación y distribución inicial de fragmentos permite una configuración más rápida del particionado zonificado. Después de la distribución inicial, el balanceador gestiona la distribución de fragmentos en adelante.

Consulta Predefinir zonas y rangos de zonas para una colección vacía o inexistente para ver un ejemplo.

Seguridad

Para los clústeres particionados que aplican control de acceso, debe autenticarse como un usuario cuyos privilegios incluyan cualquiera de los siguientes:

update en la colección shards en la base de datos config; o, alternativamente,
enableSharding en el recurso de clúster.

Los roles clusterAdmin integrados o clusterManager tienen los permisos adecuados para addShardToZone emitir. Consulte la página de documentación sobre 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 la zona LGA y la zona JFK. En un clúster equilibrado, MongoDB enruta las lecturas y escrituras cubiertas por cualquier zona a shard0000.

Volver

agregar fragmento

analizarClaveDeFragmento