Skalieren und Konfigurieren von Azure DocumentDB-Cluster

Azure DocumentDB bietet nahtlose Skalierbarkeit und regionale Hochverfügbarkeit (HA). Dieses Dokument dient als Schnellanleitung für Entwickler, die erfahren möchten, wie sie ihre Cluster skalieren und konfigurieren.

Voraussetzungen

Ein Azure-Abonnement
- Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein free-Konto

Ein vorhandener Azure DocumentDB-Cluster
- Wenn Sie keinen Cluster haben, erstellen Sie einen neuen Cluster.

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Get started with Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen möchten, install die Azure CLI. Wenn Sie Windows oder macOS verwenden, ziehen Sie in Betracht, Azure CLI in einem Docker-Container auszuführen. Weitere Informationen finden Sie unter How to run the Azure CLI in a Docker container.
- Wenn Sie eine lokale Installation verwenden, melden Sie sich mit dem Befehl az login beim Azure CLI an. Um den Authentifizierungsprozess abzuschließen, führen Sie die schritte aus, die in Ihrem Terminal angezeigt werden. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe von Azure CLI.
- Wenn Sie dazu aufgefordert werden, installieren Sie die Azure CLI Erweiterung bei der ersten Verwendung. Weitere Informationen zu Erweiterungen finden Sie unter Use and manage extensions with the Azure CLI.
- Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um auf die neueste Version zu aktualisieren.

Skalierungsclusterberechnung

Auf der Clusterebene können Sie die Anzahl der vCores und die Menge des RAM auf den physischen Shards Ihres Clusters konfigurieren. Sie können die Clusterebene jederzeit ohne Unterbrechung an Ihre Anforderungen anpassen. Sie können beispielsweise von M50 auf M60 erhöhen oder von M50 auf M40 verringern.

Wählen Sie auf der Cluster-Randleiste unter Einstellungen die Option Skalieren aus.
Um die Cluster-Ebene zu ändern, wählen Sie im Drop-down-Menü die neue Ebene aus.
Wählen Sie Speichern aus, um Ihre Änderung beizubehalten.

Um die Computeebene des Clusters nach oben oder unten zu skalieren, aktualisieren Sie den vorhandenen Cluster mit einem update Vorgang, indem Sie den MXXX Wert in der compute.tier Eigenschaft ändern.

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

Sie können die Azure REST-API direkt verwenden oder sie in az rest aus der Azure-CLI-Umgebung einbinden.

Verwenden Sie diesen Befehl, um die Computeebene des Clusters zu ändern:

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

Tipp

Wenn Sie das Azure Cloud Shell verwenden, können Sie Dateien direkt in die Shell hochladen/herunterladen. Weitere Informationen finden Sie unter managed files in Azure Cloud Shell.

Hinweis

Das Downgrade von der regulären Computeebene auf eine burstbare Ebene wird nicht unterstützt.

Erhöhen Sie die Speichergröße.

Sie können die Speicherkapazität erhöhen, um Ihrer Datenbank mehr Platz zu bieten, um zu wachsen. Sie können beispielsweise den Speicher von 128 GiB auf 256 GiB erhöhen.

Um die Speichergröße zu erhöhen, wählen Sie im Drop-down-Menü die neue Größe aus.
Wählen Sie Speichern aus, um Ihre Änderung beizubehalten.

Um die Größe des Clusterspeichers zu erhöhen, aktualisieren Sie den vorhandenen Cluster mit einem update Vorgang, indem Sie den Wert in der storage.sizeGb Eigenschaft erhöhen.

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

Sie können die Azure REST-API direkt verwenden oder in az rest in der Azure CLI Umgebung eingebettet verwenden.

Verwenden Sie diesen Befehl, um die Computeebene des Clusters zu ändern:

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

Tipp

Wenn Sie das Azure Cloud Shell verwenden, können Sie Dateien direkt in die Shell hochladen/herunterladen. Weitere Informationen finden Sie unter managed files in Azure Cloud Shell.

Von Bedeutung

Die Speichergröße kann nur erhöht und nicht verringert werden.

Aktivieren oder Deaktivieren von Hochverfügbarkeit

Sie können in der Region hohe Verfügbarkeit (HA) entsprechend Ihren Anforderungen aktivieren oder deaktivieren. Hochverfügbarkeit innerhalb der Region vermeidet Datenbankausfälle, indem Replikatshards jeder primären Shard in einem Cluster verwaltet werden. Wenn eine primäre Shard ausfällt, werden eingehende Verbindungen automatisch an die Replikatshard umgeleitet, um sicherzustellen, dass es zu minimalen Ausfallzeiten kommt.

Um die In-Region HA zu aktivieren oder zu deaktivieren, schalten Sie die Kontrollkästchenoption um.
Wählen Sie Speichern aus, um Ihre Änderung beizubehalten.

Aktualisieren Sie den vorhandenen Cluster mit einem Vorgang, um die hohe Verfügbarkeit in der Region im Cluster zu update, indem Sie den Wert in der highAvailability.targetMode Eigenschaft auf ZoneRedundantPreferredfestlegen.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="ZoneRedundantPreferred"
```
Um die hohe Verfügbarkeit in der Region auf dem Cluster zu deaktivieren , aktualisieren Sie den vorhandenen Cluster mit einem update Vorgang, indem Sie den Wert in der highAvailability.targetMode Eigenschaft auf Disabledfestlegen.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.highAvailability.targetMode="Disabled"
```

Sie können die Azure REST-API direkt verwenden oder in az rest aus der Azure CLI-Umgebung eingebunden nutzen.

Verwenden Sie diesen Befehl, um hohe Verfügbarkeit in der Region im Cluster zu aktivieren :

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

Verwenden Sie diesen Befehl, um die hohe Verfügbarkeit in der Region im Cluster zu deaktivieren :

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

Erhöhen der Anzahl der physischen Shards

Wenn eine Datenbank über die Kapazität eines einzelnen physischen Shardclusters hinaus wächst, können Sie entweder die Speichergröße erhöhen oder weitere physische Shards hinzufügen. Nachdem dem Cluster ein neuer physischer Shard hinzugefügt wurde, müssen Sie einen Cluster-Rebalancing-Vorgang ausführen, um Daten über die Shards weiterzuverwenden. Jeder physische Shard in einem Cluster verfügt immer über dieselbe Compute- und Speicherkonfiguration .

Wenn Sie physische Shards hinzufügen möchten, wählen Sie in der Liste die neue Shardanzahl aus.
Wählen Sie Speichern aus, um Ihre Änderung beizubehalten.
Wählen Sie Weiter im Popupfenster aus, um Ihre Änderung beizubehalten.

Um dem Cluster einen physischen Shard hinzuzufügen, aktualisieren Sie den vorhandenen Cluster mit einem update Vorgang, indem Sie den Wert für die sharding.shardCount Eigenschaft um eins erhöhen.
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
Hinweis

Sie können jeweils nur einen physischen Shard hinzufügen. Wenn Sie dem Cluster mehrere physische Shards hinzufügen müssen, müssen Sie sie sequenziell ausführen.

Sie können die Azure REST-API direkt verwenden oder aus der Azure CLI-Umgebung in az rest eingebunden verwenden.

Verwenden Sie diesen Befehl, um dem Cluster einen physischen Shard hinzuzufügen:

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

Hinweis

Sie können jeweils nur einen physischen Shard hinzufügen. Wenn Sie dem Cluster mehrere physische Shards hinzufügen müssen, müssen Sie sie sequenziell ausführen.

Tipp

Wenn Sie mehr als 10 physische Shards auf Ihrem Cluster benötigen, öffnen Sie ein Supportticket.

Neuausbalancieren von Daten

Nachdem ein physischer Shard zu einem Cluster hinzugefügt wurde oder ein Multishard-Cluster über eine ungleiche Speicherauslastung seiner physischen Shards verfügt, verteilt die Datenumverteilung die Daten ohne Ausfallzeiten zwischen den Shards neu.

In der Vorschau muss der Datenausgleich im Cluster aktiviert werden:

Öffnen Sie im Azure Portal Clustereigenschaften.
Wählen Sie unter "Einstellungen " auf der Seite "Features " die Option "Rebalancer" für Multishardcluster aus.
Wählen Sie im Bereich Rebalancer für Multishard-ClusterAktivieren aus.

Um die Daten-Neuausrichtung zu starten, verbinden Sie sich mit dem Cluster mithilfe eines Verwaltungstools, wie der Mongo-Shell.

Starten Sie den Rebalancer mit dem sh.startBalancer() Befehl.
Überprüfen Sie den Rebalancerstatus mithilfe von sh.isBalancerRunning().
Beenden Sie den Rebalancer mit dem sh.stopBalancer() Befehl.

Hinweis

Die Dauer des Neuabgleichsprozesses hängt vom Datenvolumen ab, das zwischen physischen Shards verschoben wird. Der Vorgang wird online ausgeführt und wirkt sich nicht auf die Verfügbarkeit oder Funktionalität des Clusters aus.

Nächste Schritte

In diesem Handbuch haben wir gezeigt, dass das Skalieren und Konfigurieren Ihres Azure DocumentDB-Clusters im Azure Portal ein einfacher Prozess ist. Das Azure Portal umfasst die Möglichkeit, die Clusterebene anzupassen, die Speichergröße zu erhöhen, hohe Verfügbarkeit zu aktivieren oder zu deaktivieren und physische Shards ohne Ausfallzeiten hinzuzufügen.

Speichern Sie einen Azure DocumentDB-Cluster

Feedback

War diese Seite hilfreich?

Last updated on 2026-04-17

Freigeben über

Skalieren und Konfigurieren von Azure DocumentDB-Cluster

Voraussetzungen

Skalierungsclusterberechnung

Erhöhen Sie die Speichergröße.

Aktivieren oder Deaktivieren von Hochverfügbarkeit

Erhöhen der Anzahl der physischen Shards

Neuausbalancieren von Daten

Nächste Schritte

Feedback

Zusätzliche Ressourcen