Skalowanie i konfigurowanie klastra usługi Azure DocumentDB

Usługa Azure DocumentDB zapewnia bezproblemową skalowalność i wysoką dostępność w regionie . Ten dokument służy jako szybki przewodnik dla deweloperów, którzy chcą dowiedzieć się, jak skalować i konfigurować klastry.

Wymagania wstępne

Subskrypcja platformy Azure
- Jeśli nie masz subskrypcji platformy Azure, utwórz bezpłatne konto

Istniejący klaster usługi Azure DocumentDB
- Jeśli nie masz klastra, utwórz nowy klaster

Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
- Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
- Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
- Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.

Skalowanie zasobów obliczeniowych klastra

Warstwa klastra umożliwia skonfigurowanie liczby rdzeni wirtualnych i ilości pamięci RAM na fizycznych fragmentach klastra. Możesz zmienić warstwę klastra tak, aby odpowiadała Twoim potrzebom w dowolnym momencie bez przerwy. Na przykład można zwiększyć z M50 do M60 lub zmniejszyć M50 do M40.

Na pasku bocznym klastra w obszarze Ustawienia wybierz pozycję Skaluj.
Aby zmienić warstwę klastra, wybierz nową warstwę z menu rozwijanego.
Wybierz pozycję Zapisz , aby utrwałyć zmianę.

Aby skalować warstwę obliczeniową klastra w górę lub w dół, zaktualizuj istniejący klaster update za pomocą operacji, zmieniając MXXX wartość we compute.tier właściwości.

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

Interfejs API REST platformy Azure można używać bezpośrednio lub opakować w az rest środowisko interfejsu wiersza polecenia platformy Azure.

Użyj tego polecenia, aby zmienić warstwę obliczeniową klastra:

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

Wskazówka

Jeśli używasz usługi Azure Cloud Shell, możesz przesyłać i pobierać pliki bezpośrednio w powłoce. Aby uzyskać więcej informacji, zobacz pliki zarządzane w usłudze Azure Cloud Shell.

Uwaga / Notatka

Obniżanie warstwy obliczeniowej z zwykłej warstwy obliczeniowej do warstwy skalowalnej nie jest obsługiwane.

Zwiększ rozmiar magazynu

Możesz zwiększyć rozmiar magazynu , aby zwiększyć ilość miejsca w bazie danych. Na przykład można zwiększyć pojemność magazynu z 128 GiB do 256 GiB.

Aby zwiększyć rozmiar magazynu, wybierz nowy rozmiar z menu rozwijanego.
Wybierz pozycję Zapisz , aby utrwałyć zmianę.

Aby zwiększyć rozmiar magazynu klastra, zaktualizuj istniejący klaster update za pomocą operacji, zwiększając wartość właściwości storage.sizeGb . Obsługiwane rozmiary magazynu są wyświetlane na stronie obsługiwanego magazynu.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.storage.sizeGb="<new-size-in-GiB>"
```

Interfejs API REST platformy Azure można używać bezpośrednio lub opakować w az rest środowisko interfejsu wiersza polecenia platformy Azure.

Użyj tego polecenia, aby zmienić warstwę obliczeniową klastra:

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

Wskazówka

Jeśli używasz usługi Azure Cloud Shell, możesz przesyłać i pobierać pliki bezpośrednio w powłoce. Aby uzyskać więcej informacji, zobacz pliki zarządzane w usłudze Azure Cloud Shell.

Ważne

Rozmiar magazynu można zwiększyć tylko, a nie zmniejszyć.

Włączanie lub wyłączanie wysokiej dostępności

Możesz włączyć lub wyłączyć wysoką dostępność w regionie zgodnie z potrzebami. HA (wysoka dostępność) w regionie pozwala uniknąć przestoju bazy danych poprzez utrzymywanie replik fragmentów każdego podstawowego fragmentu w klastrze. Jeśli podstawowy fragment ulegnie awarii, połączenia przychodzące są automatycznie przekierowywane do fragmentu repliki, zapewniając minimalny przestój.

Aby włączyć lub wyłączyć wysoką dostępność w regionie, zaznacz lub odznacz pole wyboru.
Wybierz pozycję Zapisz , aby utrwałyć zmianę.

Aby włączyć wysoką dostępność w regionie w klastrze, zaktualizuj istniejący klaster update za pomocą operacji, ustawiając wartość we highAvailability.targetMode właściwości na ZoneRedundantPreferred.

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

Aby wyłączyć wysoką dostępność w regionie w klastrze, zaktualizuj istniejący klaster update za pomocą operacji, ustawiając wartość we highAvailability.targetMode właściwości na Disabled.

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

Interfejs API REST platformy Azure można używać bezpośrednio lub opakować w az rest środowisko interfejsu wiersza polecenia platformy Azure.

Użyj tego polecenia, aby włączyć wysoką dostępność w regionie w klastrze:

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

Użyj tego polecenia, aby wyłączyć wysoką dostępność w regionie w klastrze:

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

Zwiększanie liczby fragmentów fizycznych

Gdy baza danych przekroczy pojemność pojedynczego fizycznego klastra fragmentów, możesz zwiększyć rozmiar magazynu lub dodać więcej fragmentów fizycznych. Po dodaniu nowego fizycznego fragmentu do klastra należy wykonać operację ponownego równoważenia klastra w celu ponownego dystrybuowania danych między fragmentami. Każdy fragment fizyczny w klastrze zawsze ma tę samą konfigurację obliczeniową i magazynową .

Aby dodać fizyczne fragmenty, wybierz z listy nową liczbę fragmentów.
Wybierz pozycję Zapisz , aby utrwałyć zmianę.
Wybierz pozycję Kontynuuj w oknie podręcznym, aby utrwały zmianę.

Aby dodać fizyczny fragment do klastra, zaktualizuj istniejący klaster update za pomocą operacji, zwiększając wartość właściwości sharding.shardCount o jeden.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Uwaga / Notatka

Jednocześnie można dodać tylko jeden fragment fizyczny. Jeśli musisz dodać więcej niż jeden fizyczny fragment do klastra, należy to zrobić sekwencyjnie.

Interfejs API REST platformy Azure można używać bezpośrednio lub opakować w az rest środowisko interfejsu wiersza polecenia platformy Azure.

Użyj tego polecenia, aby dodać fizyczny fragment do klastra:

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

Uwaga / Notatka

Jednocześnie można dodać tylko jeden fragment fizyczny. Jeśli musisz dodać więcej niż jeden fizyczny fragment do klastra, należy to zrobić sekwencyjnie.

Wskazówka

Jeśli potrzebujesz więcej niż 10 fizycznych fragmentów w klastrze, otwórz zgłoszenie do pomocy technicznej.

Ponowne równoważenie danych

Po dodaniu fizycznego fragmentu do klastra lub jeśli klaster wieloczęściowy ma nierówne użycie magazynu w swoich fizycznych fragmentach, dane ponownie równoważą dane między fragmentami bez żadnych przestojów.

W wersji zapoznawczej ponowne równoważenie danych musi być włączone w klastrze:

W witrynie Azure Portal otwórz właściwości klastra.
W obszarze Ustawienia na stronie Funkcje wybierz pozycję Rebalancer for multishard clusters.
W panelu Ponowne równoważenie dla klastrów wieloczęściowych wybierz pozycję Włącz.

Aby zainicjować ponowne równoważenie danych, połącz się z klastrem przy użyciu narzędzia do zarządzania, takiego jak powłoka Mongo.

Uruchom moduł równoważenia za pomocą polecenia sh.startBalancer().
Sprawdź stan ponownego równoważenia przy użyciu polecenia sh.isBalancerRunning().
Zatrzymaj ponowne równoważenie poleceniem sh.stopBalancer().

Uwaga / Notatka

Czas trwania procesu ponownego równoważenia zależy od ilości danych przenoszonych między fragmentami fizycznymi. Operacja jest wykonywana w trybie online i nie ma wpływu na dostępność ani funkcjonalność klastra.

Dalsze kroki

W tym przewodniku pokazano, że skalowanie i konfigurowanie klastra usługi Azure DocumentDB w witrynie Azure Portal jest prostym procesem. Portal Azure obejmuje możliwość dostosowywania warstwy klastra, zwiększania rozmiaru magazynu, włączania lub wyłączania wysokiej dostępności oraz dodawania fragmentów fizycznych bez żadnych przestojów.

Przywracanie klastra usługi Azure DocumentDB

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-11-19

Udostępnij przez

Skalowanie i konfigurowanie klastra usługi Azure DocumentDB

Wymagania wstępne

Skalowanie zasobów obliczeniowych klastra

Zwiększ rozmiar magazynu

Włączanie lub wyłączanie wysokiej dostępności

Zwiększanie liczby fragmentów fizycznych

Ponowne równoważenie danych

Dalsze kroki

Sprzężenie zwrotne

Dodatkowe źródła