Mise à l’échelle et configuration du cluster Azure DocumentDB

Azure DocumentDB offre une scalabilité transparente et une haute disponibilité dans la région. Ce document sert de guide rapide pour les développeurs qui souhaitent apprendre à mettre à l’échelle et configurer leurs clusters.

Prerequisites

• Un abonnement Azure

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit

• Un cluster Azure DocumentDB existant

  • Si vous n’avez pas de cluster, créez un cluster

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.

  

• Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Comment exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Mettre à l’échelle le calcul du cluster

Le niveau de cluster vous permet de configurer le nombre de vCores et la quantité de RAM sur les partitions physiques de votre cluster. Vous pouvez modifier le niveau du cluster en fonction de vos besoins à tout moment sans interruption. Par exemple, vous pouvez augmenter de M50 à M60 ou diminuer M50 à M40.

portail Azure

1. Dans la barre latérale du cluster, sous Paramètres, sélectionnez Mettre à l’échelle.

2. Pour modifier le niveau du cluster, sélectionnez le nouveau niveau dans le menu déroulant.

   

3. Sélectionnez Enregistrer pour appliquer votre modification.

Azure CLI

1. Pour mettre à l’échelle le niveau de calcul du cluster vers le haut ou vers le bas, mettez à jour le cluster existant avec une opération update en modifiant la valeur MXXX dans la propriété compute.tier.

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

API REST

Vous pouvez utiliser l’API REST Azure directement ou encapsulée à az rest partir de l’environnement Azure CLI.

1. Utilisez cette commande pour modifier le niveau de calcul du cluster :

   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>\"}}}"
   

   Conseil / Astuce

   Si vous utilisez Azure Cloud Shell, vous pouvez charger/télécharger des fichiers directement dans l’interpréteur de commandes. Pour plus d’informations, consultez les fichiers managés dans Azure Cloud Shell.

Note

La rétrogradation du niveau de calcul standard vers un niveau burstable n’est pas prise en charge.

Augmentez la taille du stockage

Vous pouvez augmenter la taille de stockage pour augmenter la taille de votre base de données. Par exemple, vous pouvez augmenter le stockage de 128 Gio à 256 Gio.

portail Azure

1. Pour augmenter la taille de stockage, sélectionnez la nouvelle taille dans le menu déroulant.

   

2. Sélectionnez Enregistrer pour appliquer votre modification.

Azure CLI

1. Pour augmenter la taille du stockage du cluster, mettez à jour le cluster existant avec une opération update en augmentant la valeur dans la propriété storage.sizeGb. Les tailles de stockage prises en charge sont répertoriées sur la page de stockage prise en charge.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.storage.sizeGb="<new-size-in-GiB>"
   

API REST

Vous pouvez utiliser l’API REST Azure directement ou encapsulée à az rest partir de l’environnement Azure CLI.

1. Utilisez cette commande pour modifier le niveau de calcul du cluster :

   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>\"}}}"
   

   Conseil / Astuce

   Si vous utilisez Azure Cloud Shell, vous pouvez charger/télécharger des fichiers directement dans l’interpréteur de commandes. Pour plus d’informations, consultez les fichiers managés dans Azure Cloud Shell.

Important

La taille de stockage peut uniquement être augmentée, et non réduite.

Activer ou désactiver la haute disponibilité

Vous pouvez activer ou désactiver la haute disponibilité dans la région pour répondre à vos besoins. La haute disponibilité dans la région évite les temps d’arrêt de la base de données en conservant des réplicas de chaque partition principale dans un cluster. Si une partition principale tombe en panne, les connexions entrantes sont automatiquement redirigées vers sa partition de réplica, ce qui garantit un temps d’arrêt minimal.

portail Azure

1. Pour activer ou désactiver la haute disponibilité dans la région, cochez ou décochez la case correspondante.

   

2. Sélectionnez Enregistrer pour appliquer votre modification.

Azure CLI

1. Pour activer la haute disponibilité dans la région sur le cluster, mettez à jour le cluster existant avec une opération update en définissant la valeur dans la propriété highAvailability.targetMode sur ZoneRedundantPreferred.

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

2. Pour désactiver la haute disponibilité dans la région sur le cluster, mettez à jour le cluster existant avec une opération update en définissant la valeur dans la propriété highAvailability.targetMode sur Disabled.

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

API REST

Vous pouvez utiliser l’API REST Azure directement ou encapsulée à az rest partir de l’environnement Azure CLI.

1. Utilisez cette commande pour activer la haute disponibilité dans la région sur le cluster :

   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\"}}}"
   

2. Utilisez cette commande pour désactiver la haute disponibilité dans la région sur le cluster :

   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\"}}}"
   

Augmenter le nombre de partitions physiques

Lorsqu’une base de données augmente au-delà de la capacité d’un seul cluster de partitions physiques, vous pouvez augmenter la taille de stockage ou ajouter davantage de partitions physiques. Une fois qu’une nouvelle partition physique est ajoutée au cluster, vous devez effectuer une opération de rééquilibrage de cluster pour redistribuer des données sur les partitions. Chaque partition physique d’un cluster a toujours la même configuration de calcul et de stockage.

portail Azure

1. Pour ajouter des partitions physiques, sélectionnez le nouveau nombre de partitions dans la liste.

   

2. Sélectionnez Enregistrer pour appliquer votre modification.

3. Sélectionnez Continuer dans la fenêtre contextuelle pour conserver votre modification.

Azure CLI

1. Pour ajouter une partition physique au cluster, mettez à jour le cluster existant avec une opération update en augmentant la valeur de la propriété sharding.shardCount par un.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.sharding.shardCount="<current-shard-count-plus-one>"
   

   Note

   Vous ne pouvez ajouter qu’une seule partition physique à la fois. Si vous devez ajouter plusieurs partitions physiques au cluster, vous devez le faire de manière séquentielle.

API REST

Vous pouvez utiliser l’API REST Azure directement ou encapsulée à az rest partir de l’environnement Azure CLI.

1. Utilisez cette commande pour ajouter une partition physique au cluster :

   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>\"}}}"
   

   Note

   Vous ne pouvez ajouter qu’une seule partition physique à la fois. Si vous devez ajouter plusieurs partitions physiques au cluster, vous devez le faire de manière séquentielle.

Conseil / Astuce

Si vous avez besoin de plus de 10 partitions physiques sur votre cluster, ouvrez un ticket de support.

Rééquilibrer les données

Une fois qu’une partition physique est ajoutée à un cluster ou si un cluster multishard a une utilisation inégale du stockage sur ses partitions physiques, le rééquilibrage des données redistribue les données entre les partitions sans temps d’arrêt.

En préversion, le rééquilibrage des données doit être activé sur le cluster :

1. Dans le portail Azure, ouvrez les propriétés du cluster.
2. Sous Paramètres de la page Fonctionnalités , sélectionnez Rééquilibrage pour les clusters à plusieurs partitions.
3. Dans le volet Rééquilibrer pour les clusters multishard , sélectionnez Activer.

Pour lancer le rééquilibrage des données, connectez-vous au cluster à l’aide d’un outil de gestion tel que l’interpréteur de commandes Mongo.

1. Démarrez le rééquilibrage avec la sh.startBalancer() commande.

2. Vérifiez le statut du rééquilibrage à l’aide de sh.isBalancerRunning().

3. Arrêtez le rééquilibrage avec la sh.stopBalancer() commande.

Note

La durée du processus de rééquilibrage dépend du volume de données déplacées entre des partitions physiques. L’opération est effectuée en ligne et n’affecte pas la disponibilité ou la fonctionnalité du cluster.

Étapes suivantes

Dans ce guide, nous avons montré que la mise à l’échelle et la configuration de votre cluster Azure DocumentDB dans le portail Azure constituent un processus simple. Le portail Azure inclut la possibilité d’ajuster le niveau de cluster, d’augmenter la taille de stockage, d’activer ou de désactiver la haute disponibilité et d’ajouter des partitions physiques sans temps d’arrêt.

• Options de calcul et de stockage
• Découvrez les principes fondamentaux du partitionnement

Restaurer un cluster Azure DocumentDB