Escalado y configuración del clúster de Azure DocumentDB

Azure DocumentDB proporciona escalabilidad sin problemas y alta disponibilidad en la región (HA). Este documento sirve como guía rápida para los desarrolladores que desean aprender a escalar y configurar sus clústeres.

Prerrequisitos

Una suscripción de Azure
- Si no tiene ninguna suscripción a Azure, cree una cuenta gratuita

Un clúster de Azure DocumentDB existente
- Si no tiene un clúster, cree un nuevo clúster.

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.
- Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
- Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

Escalado del proceso de clúster

El nivel de clúster permite configurar el número de núcleos virtuales y la cantidad de RAM en las particiones físicas del clúster. Puede cambiar el nivel de clúster para satisfacer sus necesidades en cualquier momento sin interrupciones. Por ejemplo, puede aumentar de M50 a M60 o disminuir de M50 a M40.

En la barra lateral del clúster, en Configuración, seleccione Escalar.
Para cambiar el nivel de clúster, seleccione el nuevo nivel en el menú desplegable.
Seleccione Guardar para mantener su cambio.

Para escalar o reducir verticalmente el nivel de proceso del clúster, actualice el clúster existente con una operación update cambiando el valor MXXX de la propiedad compute.tier.

az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.compute.tier="<compute-tier>"

Puede usar la API de REST de Azure directamente o encapsulada en az rest desde el entorno de la CLI de Azure.

Use este comando para cambiar el nivel de proceso del clúster:

az rest \
   --method "PATCH" \
   --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
   --body "{\"location\":\"<cluster-region>\",\"properties\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"

Sugerencia

Si usa Azure Cloud Shell, puede cargar o descargar archivos directamente en el shell. Para más información, consulte Archivos administrados en Azure Cloud Shell.

Nota:

No se admite la degradación del nivel de proceso normal a un nivel con ráfagas.

Aumente el tamaño de almacenamiento.

Puede aumentar el tamaño de almacenamiento para dar a la base de datos más espacio para crecer. Por ejemplo, puede aumentar el almacenamiento de 128 GiB a 256 GiB.

Para aumentar el tamaño de almacenamiento, seleccione el nuevo tamaño en el menú desplegable.
Seleccione Guardar para mantener su cambio.

Para aumentar el tamaño de almacenamiento del clúster, actualice el clúster existente con una operación update aumentando el valor de la propiedad storage.sizeGb. Los tamaños de almacenamiento admitidos aparecen en la página de almacenamiento compatible.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.storage.sizeGb="<new-size-in-GiB>"
```

Puede usar la API de REST de Azure directamente o encapsulada en az rest desde el entorno de la CLI de Azure.

Use este comando para cambiar el nivel de proceso del clúster:

az rest \
   --method "PATCH" \
   --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
   --body "{\"location\":\"<cluster-region>\",\"properties\":{\"storage\":{\"sizeGb\":\"<new-size-in-GiB>\"}}}"

Sugerencia

Si usa Azure Cloud Shell, puede cargar o descargar archivos directamente en el shell. Para más información, consulte Archivos administrados en Azure Cloud Shell.

Importante

El tamaño del almacenamiento solo se puede aumentar, no disminuir.

Habilitar o deshabilitar la alta disponibilidad

Puede habilitar o deshabilitar la alta disponibilidad en la región (HA) para satisfacer sus necesidades. La alta disponibilidad (HA) en la región evita el tiempo de inactividad de la base de datos al mantener fragmentos de réplica de cada fragmento principal en un clúster. Si una partición primaria se cae, las conexiones entrantes se redirigen automáticamente a su partición de réplica, asegurando que el tiempo de inactividad sea mínimo.

Para habilitar o deshabilitar la alta disponibilidad en la región, marque o desmarque la casilla de verificación.
Seleccione Guardar para mantener su cambio.

Para habilitar la alta disponibilidad en la región en el clúster, actualice el clúster existente con una operación update estableciendo el valor de la propiedad highAvailability.targetMode en ZoneRedundantPreferred.

az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="ZoneRedundantPreferred"

Para deshabilitar la alta disponibilidad en la región en el clúster, actualice el clúster existente con una operación update estableciendo el valor de la propiedad highAvailability.targetMode en Disabled.

az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="Disabled"

Puede usar la API de REST de Azure directamente o encapsulada en az rest desde el entorno de la CLI de Azure.

Use este comando para habilitar la alta disponibilidad en la región en el clúster:

az rest \
   --method "PATCH" \
   --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
   --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"ZoneRedundantPreferred\"}}}"

Use este comando para deshabilitar la alta disponibilidad en la región en el clúster:

az rest \
   --method "PATCH" \
   --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
   --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"Disabled\"}}}"

Aumentar el número de fragmentos físicos

Cuando una base de datos crece más allá de la capacidad de un único clúster de particiones físicas, puede aumentar el tamaño de almacenamiento o agregar más particiones físicas. Después de agregar una nueva partición física al clúster, debe realizar una operación de reequilibrio de clúster para redistribuir los datos entre las particiones. Cada partición física de un clúster siempre tiene la misma configuración de proceso y almacenamiento .

Para agregar particiones físicas, seleccione nuevo recuento de particiones en la lista.
Seleccione Guardar para mantener su cambio.
Seleccione Continuar en la ventana emergente para conservar el cambio.

Para agregar una partición física al clúster, actualice el clúster existente con una operación update aumentando el valor de la propiedad sharding.shardCount en uno.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Nota:

Solo puede agregar una partición física a la vez. Si necesita agregar más de una partición física al clúster, debe hacerlo secuencialmente.

Puede usar la API de REST de Azure directamente o encapsulada en az rest desde el entorno de la CLI de Azure.

Use este comando para agregar una partición física al clúster:

az rest \
   --method "PATCH" \
   --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
   --body "{\"location\":\"<cluster-region>\",\"properties\":{\"sharding\":{\"shardCount\":\"<current-shard-count-plus-one>\"}}}"

Nota:

Solo puede agregar una partición física a la vez. Si necesita agregar más de una partición física al clúster, debe hacerlo secuencialmente.

Sugerencia

Si necesita más de 10 particiones físicas en su clúster, abra un ticket de soporte.

Reequilibrar datos

Después de agregar una partición física a un clúster, o si el clúster de varias particiones tiene un uso de almacenamiento desigual en sus particiones físicas, el reequilibrio de datos redistribuye los datos entre particiones sin tiempo de inactividad.

En versión preliminar, es necesario habilitar el reequilibrio de datos en el clúster:

En Azure Portal, abra las propiedades del clúster.
En Configuración en la página Características , seleccione Reequilibrar para clústeres de varias particiones.
En el panel Rebalancer para clústeres de varias particiones , seleccione Habilitar.

Para iniciar el reequilibrio de datos, conéctese al clúster mediante una herramienta de administración como el shell de Mongo.

Inicie el reequilibrio con el sh.startBalancer() comando .
Compruebe el estado del reequilibrio mediante sh.isBalancerRunning().
Detenga el reequilibrio con el sh.stopBalancer() comando .

Nota:

La duración del proceso de reequilibrio depende del volumen de datos que se mueven entre particiones físicas. La operación se realiza en línea y no afecta a la disponibilidad o funcionalidad del clúster.

Pasos siguientes

En esta guía, hemos mostrado que el escalado y la configuración del clúster de Azure DocumentDB en Azure Portal es un proceso sencillo. Azure Portal incluye la capacidad de ajustar el nivel de clúster, aumentar el tamaño de almacenamiento, habilitar o deshabilitar la alta disponibilidad y agregar particiones físicas sin tiempo de inactividad.

Restauración de un clúster de Azure DocumentDB

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-19

Compartir a través de

Escalado y configuración del clúster de Azure DocumentDB

Prerrequisitos

Escalado del proceso de clúster

Aumente el tamaño de almacenamiento.

Habilitar o deshabilitar la alta disponibilidad

Aumentar el número de fragmentos físicos

Reequilibrar datos

Pasos siguientes

Comentarios

Recursos adicionales