缩放和配置 Azure DocumentDB 群集

Azure DocumentDB 提供无缝可伸缩性和区域内高可用性（HA）。本文档为想要了解如何缩放和配置群集的开发人员提供了快速指南。

先决条件

Azure 订阅服务
- 如果没有 Azure 订阅，请创建试用版

现有的 Azure DocumentDB 群集
- 如果没有群集，请创建新群集

如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展的详细信息，请参阅将扩展与 Azure CLI 配合使用。
- 运行az version命令，以查看已安装的版本和依赖库。若要升级到最新版本，请运行az upgrade。

扩展集群计算

群集层允许配置群集物理分片上的 vCore 数量和 RAM 数量。可以随时根据需要更改群集层，而无需中断。例如，可以从 M50 增加到 M60 或从 M50 减少到 M40。

Azure 门户
Azure CLI
REST API

在群集边栏的“设置”下，选择“缩放”。
若要更改群集层，请从下拉菜单中选择新层。
选择“保存”以保存更改。

要扩大或缩小集群计算层，请通过更改 update 属性中的 MXXX 值，使用 compute.tier 操作来更新现有群集。

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

可以直接使用 Azure REST API，或者在 Azure CLI 环境中结合 az rest 一起使用。

使用此命令更改群集计算层：

az rest \
   --method "PATCH" \
   --url "https://management.chinacloudapi.cn/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>\"}}}"

小窍门

如果使用 Azure Cloud Shell，可以直接将文件上载/下载到 shell。有关详细信息，请参阅 Azure Cloud Shell 中的托管文件。

注释

不支持从常规计算层降级到可突发层。

增大存储大小

可以增加存储大小，以增加数据库增长空间。例如，可以将存储从 128 GiB 增加到 256 GiB。

Azure 门户
Azure CLI
REST API

若要增加存储大小，请从下拉菜单中选择新大小。
选择“保存”以保存更改。

若要增加群集存储大小，请使用 update 操作更新现有群集，方法是增加属性中的 storage.sizeGb 值。支持的存储大小已在支持的存储页面上列出。

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

可以直接使用 Azure REST API，或者在 Azure CLI 环境中结合 az rest 一起使用。

使用此命令更改群集计算层：

az rest \
   --method "PATCH" \
   --url "https://management.chinacloudapi.cn/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>\"}}}"

小窍门

如果使用 Azure Cloud Shell，可以直接将文件上载/下载到 shell。有关详细信息，请参阅 Azure Cloud Shell 中的托管文件。

重要

存储大小只能增加，而不能减小。

启用或禁用高可用性

可以根据需要启用或禁用区域内高可用性（HA ）。区域内 HA 通过维护群集中每个主分片的副本分片来避免数据库停机。如果主分片出现故障，则传入连接会自动重定向到其副本分片，以确保故障时间最短。

Azure 门户
Azure CLI
REST API

若要启用或禁用区域内 HA，请切换复选框选项。
选择“保存”以保存更改。

要在群集上启用区域内高可用性，请通过将属性中的值设置为 update 来使用 highAvailability.targetMode 操作更新现有群集ZoneRedundantPreferred。

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

要在群集上禁用区域内高可用性，请通过将属性中的值设置为 update 来使用 highAvailability.targetMode 操作更新现有群集Disabled。

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

可以直接使用 Azure REST API，或者在 Azure CLI 环境中结合 az rest 一起使用。

使用此命令在群集上启用区域内高可用性：

az rest \
   --method "PATCH" \
   --url "https://management.chinacloudapi.cn/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\"}}}"

使用此命令在群集上禁用区域内高可用性：

az rest \
   --method "PATCH" \
   --url "https://management.chinacloudapi.cn/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\"}}}"

增加物理分片数

当数据库超出单个物理分片群集的容量时，可以增加存储大小或添加更多物理分片。将新的物理分片添加到群集后，必须执行群集重新均衡作，以便跨分片重新分发数据。群集中的每个物理分片始终具有相同的计算和存储配置。

Azure 门户
Azure CLI
REST API

若要添加物理分片，请从列表中选择新的分片数量。
选择“保存”以保存更改。
在弹出窗口中选择“继续”以保留更改。

要向群集添加物理分片，请通过将 update 属性的值增加 1 来使用 sharding.shardCount 操作更新现有集群。
```
az resource update \
  --resource-type "Microsoft.DocumentDB/mongoClusters" \
  --name "<cluster-name>" \
  --resource-group "<resource-group>" \
  --set properties.sharding.shardCount="<current-shard-count-plus-one>"
```
注释

一次只能添加一个物理分片。如果需要将多个物理分片添加到群集，则需要按顺序执行此操作。

可以直接使用 Azure REST API，或者在 Azure CLI 环境中结合 az rest 一起使用。

使用此命令将物理分片添加到群集：

az rest \
   --method "PATCH" \
   --url "https://management.chinacloudapi.cn/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>\"}}}"

注释

一次只能添加一个物理分片。如果需要将多个物理分片添加到群集，则需要按顺序执行此操作。

小窍门

如果在群集上需要 10 个以上的物理分片，请开具支持票证。

重新平衡数据

将物理分片添加到群集后，或者如果多分片群集在其物理分片中存储使用率不均衡，数据重新均衡会重新分发分片之间的数据，而不会造成任何停机。

在预览版中，需要在群集上启用数据重新均衡：

在 Azure 门户中，打开群集属性。
在“功能”页上的“设置”下，为多分片群集选择“重新平衡器”。
在 多分片群集面板的“重新平衡器 ”中，选择“ 启用”。

若要启动数据重新均衡，请使用管理工具（如 Mongo shell）连接到群集。

使用 sh.startBalancer() 命令启动重新平衡器。
使用 sh.isBalancerRunning() 检查重新平衡器状态。
使用 sh.stopBalancer() 命令停止重新平衡器。

注释

重新均衡过程的持续时间取决于在物理分片之间移动的数据量。该作联机执行，不会影响群集可用性或功能。

后续步骤

本指南介绍了在 Azure 门户中缩放和配置 Azure DocumentDB 群集的过程非常简单。 Azure 门户提供了调整群集层级、扩展存储空间、启用或禁用高可用性，以及在无需停机的情况下添加物理分片的功能。

还原 Azure DocumentDB 群集

Last updated on 2025-12-11

通过

缩放和配置 Azure DocumentDB 群集

先决条件

扩展集群计算

增大存储大小

启用或禁用高可用性

增加物理分片数

重新平衡数据

后续步骤

其他资源