Škálování a konfigurace clusteru Azure DocumentDB

Azure DocumentDB poskytuje bezproblémovou škálovatelnost a vysokou dostupnost v jednotlivých oblastech. Tento dokument slouží jako rychlá příručka pro vývojáře, kteří chtějí zjistit, jak škálovat a konfigurovat clustery.

Požadavky

• Předplatné Azure

  • Pokud ještě předplatné Azure nemáte, vytvořte si bezplatný účet.

• Existující cluster Azure DocumentDB

  • Pokud cluster nemáte, vytvořte nový cluster.

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud chcete spouštět referenční příkazy CLI lokálně, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Pro více informací, viz Jak spustit Azure CLI v Docker kontejneru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Chcete-li dokončit proces ověřování, postupujte podle kroků zobrazených ve vašem terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Když budete vyzváni, nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Škálování výpočetního výkonu clusteru

Úroveň clusteru umožňuje nakonfigurovat počet virtuálních jader a velikost paměti RAM ve fyzických horizontálních oddílech clusteru. Úroveň clusteru můžete kdykoli změnit tak, aby vyhovovala vašim potřebám bez přerušení. Můžete například zvýšit z M50 na M60 nebo snížit M50 na M40.

Azure Portal

1. Na bočním panelu clusteru v části Nastavení vyberte Škálovat.

2. Pokud chcete změnit úroveň clusteru, vyberte novou úroveň z rozevírací nabídky.

   

3. Chcete-li zachovat změnu, vyberte Uložit .

Azure CLI

1. Pokud chcete vertikálně navýšit nebo snížit kapacitu výpočetní úrovně clusteru, aktualizujte stávající cluster update operací změnou MXXX hodnoty ve compute.tier vlastnosti.

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

Rozhraní REST API

Rozhraní Azure REST API můžete použít přímo nebo zabalit do prostředí Azure CLI pomocí az rest.

1. Pomocí tohoto příkazu můžete změnit úroveň výpočetních prostředků clusteru:

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

   Návod

   Pokud používáte Azure Cloud Shell, můžete nahrát nebo stáhnout soubory přímo do prostředí. Další informace najdete v tématu spravované soubory ve službě Azure Cloud Shell.

Poznámka:

Downgrade z běžné úrovně výpočetních prostředků na nárazovou úroveň se nepodporuje.

Zvětšete úložiště.

Velikost úložiště můžete zvětšit, abyste databázi zvětšili. Úložiště můžete například zvýšit z 128 GiB na 256 GiB.

Azure Portal

1. Pokud chcete zvětšit velikost úložiště, vyberte v rozevírací nabídce novou velikost.

   

2. Chcete-li zachovat změnu, vyberte Uložit .

Azure CLI

1. Pokud chcete zvětšit velikost úložiště clusteru, aktualizujte stávající cluster operací update zvýšením hodnoty ve storage.sizeGb vlastnosti. Podporované velikosti úložiště jsou uvedené na stránce podporovaného úložiště.

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

Rozhraní REST API

Rozhraní Azure REST API můžete použít přímo nebo zabalit do prostředí Azure CLI pomocí az rest.

1. Pomocí tohoto příkazu můžete změnit úroveň výpočetních prostředků clusteru:

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

   Návod

   Pokud používáte Azure Cloud Shell, můžete nahrát nebo stáhnout soubory přímo do prostředí. Další informace najdete v tématu spravované soubory ve službě Azure Cloud Shell.

Důležité

Velikost úložiště se dá zvětšit, ne zmenšit.

Povolení nebo zakázání vysoké dostupnosti

Vysokou dostupnost v jednotlivých oblastech můžete povolit nebo zakázat tak, aby vyhovovala vašim potřebám. Vysoká dostupnost v oblasti zabraňuje výpadkům databáze tím, že udržuje horizontální oddíly repliky každého primárního horizontálního oddílu v clusteru. Pokud dojde k výpadku primárního fragmentu, příchozí připojení se automaticky přesměrují na replikový fragment, což zajistí minimální výpadek.

Azure Portal

1. Pokud chcete povolit nebo zakázat vysokou dostupnost v oblasti, přepněte možnost zaškrtávacího políčka.

   

2. Chcete-li zachovat změnu, vyberte Uložit .

Azure CLI

1. Chcete-li povolit vysokou dostupnost v oblasti v clusteru, aktualizujte existující cluster update operací nastavením hodnoty ve highAvailability.targetMode vlastnosti na ZoneRedundantPreferredhodnotu .

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

2. Chcete-li zakázat vysokou dostupnost v oblasti v clusteru, aktualizujte existující cluster update operací nastavením hodnoty ve highAvailability.targetMode vlastnosti na Disabledhodnotu .

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

Rozhraní REST API

Rozhraní Azure REST API můžete použít přímo nebo zabalit do prostředí Azure CLI pomocí az rest.

1. Pomocí tohoto příkazu povolte vysokou dostupnost v oblasti v clusteru:

   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. Pomocí tohoto příkazu zakažte vysokou dostupnost v oblasti v clusteru:

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

Zvýšení počtu fyzických datových shardů

Když databáze překročí kapacitu jednoho fyzického clusteru horizontálních oddílů, můžete buď zvětšit velikost úložiště , nebo přidat další fyzické horizontální oddíly. Po přidání nového fyzického horizontálního oddílu do clusteru je nutné provést operaci vyrovnávání clusteru, aby bylo možné distribuovat data napříč horizontálními oddíly. Každý fyzický shard v clusteru má vždy stejnou konfiguraci výpočetních zdrojů a úložiště.

Azure Portal

1. Pokud chcete přidat fyzické díly, vyberte v seznamu nový počet dílů.

   

2. Chcete-li zachovat změnu, vyberte Uložit .

3. Výběrem možnosti Pokračovat v automaticky otevíraných otevíraných oknech změny zachováte.

Azure CLI

1. Pokud chcete do clusteru přidat fyzický horizontální oddíl, aktualizujte existující cluster update operací zvýšením hodnoty vlastnosti sharding.shardCount o jednu.

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

   Poznámka:

   Současně můžete přidat pouze jeden fyzický horizontální oddíl. Pokud potřebujete do clusteru přidat více fyzických horizontálních oddílů, musíte to udělat postupně.

Rozhraní REST API

Rozhraní Azure REST API můžete použít přímo nebo zabalit do prostředí Azure CLI pomocí az rest.

1. Pomocí tohoto příkazu přidejte do clusteru fyzický horizontální oddíl:

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

   Poznámka:

   Současně můžete přidat pouze jeden fyzický horizontální oddíl. Pokud potřebujete do clusteru přidat více fyzických horizontálních oddílů, musíte to udělat postupně.

Návod

Pokud v clusteru potřebujete více než 10 fyzických shardů, odešlete žádost o podporu.

Přebalancování dat

Po přidání fyzického segmentu do clusteru nebo pokud má cluster s více segmenty nerovnoměrné využití úložiště napříč fyzickými segmenty, redistribuce dat mezi segmenty probíhá bez přerušení dostupnosti.

Ve verzi Preview je potřeba povolit vyrovnávání dat v clusteru:

1. Na webu Azure Portal otevřete vlastnosti clusteru.
2. V části Nastavení na stránce Funkce vyberte Znovu vyvážit pro clustery s více horizontálními oddíly.
3. Na panelu Znovu vyvážení pro clustery s více horizontálními oddíly vyberte Povolit.

Pokud chcete zahájit vyrovnávání dat, připojte se ke clusteru pomocí správce jako je Mongo shell.

1. Spusťte rebalancer příkazem sh.startBalancer() .

2. Zkontrolujte stav rebalanceru pomocí .sh.isBalancerRunning()

3. Zastavte rebalancer pomocí sh.stopBalancer() příkazu.

Poznámka:

Doba trvání procesu vyrovnávání závisí na objemu dat, který se přesouvá mezi fyzickými shardy. Operace se provádí online a nemá vliv na dostupnost nebo funkčnost clusteru.

Další kroky

V této příručce jsme ukázali, že škálování a konfigurace clusteru Azure DocumentDB na webu Azure Portal je jednoduchý proces. Azure Portal zahrnuje možnost upravit úroveň clusteru, zvýšit velikost úložiště, povolit nebo zakázat vysokou dostupnost a přidat fyzické horizontální oddíly bez jakýchkoli výpadků.

• Možnosti výpočetních prostředků a úložiště
• Přečtěte si základy sharding.

Obnovení clusteru Azure DocumentDB