Azure DocumentDB 中的高性能存储(预览版)

Azure DocumentDB 高性能存储使用 高级 SSD v2 为 I/O 密集型工作负荷提供一致的低延迟和可预测的 IOPS。 此功能使你能够基于计算和存储配置实现性能缩放,最大限度地提高每个 vCore 的吞吐量和效率。

Guidance

Azure DocumentDB 群集 的最大存储性能 取决于所选 计算层存储大小 的组合。 每个组合确定 IOPS吞吐量的有效限制。 首先选择所需的存储大小,然后选择一个计算层,该层为工作负荷提供所需的每秒输入/输出作(IOPS)和吞吐量。 如果不确定性能要求:

  • 从完全解锁所选大小的存储性能的计算层开始。

  • 运行工作负荷基准。

  • 逐渐减少计算,直到找到提供所需性能的最小层。

IOPS 和吞吐量上限

本部分列出了 Azure DocumentDB 每个层的 IOPS 和吞吐量限制:

有关层的详细信息,请参阅 计算层和存储层

2 vCores (M30)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 3,750 3,750 3,750 3,750 3,750 3,750 3,750 3,750 3,750 3,750 3,750 3,750
最大吞吐量(MB/秒) 85 85 85 85 85 85 85 85 85 85 85 85

4 vCores (M40)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 6,400 6,400 6,400 6,400 6,400 6,400 6,400 6,400 6,400 6,400 6,400 6,400
最大吞吐量(MB/秒) 145 145 145 145 145 145 145 145 145 145 145 145

8 vCores (M50)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 12,800 12,800 12,800 12,800 12,800 12,800 12,800 12,800 12,800 12,800 12,800 12,800
最大吞吐量(MB/秒) 290 290 290 290 290 290 290 290 290 290 290 290

16 vCores (M60)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 16,000 25,600 25,600 25,600 25,600 25,600 25,600 25,600 25,600 25,600 25,600 25,600
最大吞吐量(MB/秒) 600 600 600 600 600 600 600 600 600 600 600 600

32 vCores (M80)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 16,000 32,000 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百 五万一千二百
最大吞吐量(MB/秒) 865 865 865 865 865 865 865 865 865 865 865 865

64 vCores (M200)

存储(GiB) 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536
最大 IOPS 16,000 32,000 64,000 80,000 80,000 80,000 80,000 80,000 80,000 80,000 80,000 80,000
最大吞吐量(MB/秒) 1,200 1,200 1,200 1,200 1,200 1,200 1,200 1,200 1,200 1,200 1,200 1,200

先决条件

  • 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

创建具有高性能存储的群集

使用 高级 SSD v2 (高性能)存储配置群集,作为群集创建步骤的一部分。

  1. 打开新的终端。

  2. 登录到 Azure CLI。

  3. 创建新的 Bicep 文件以定义角色定义。 将文件命名 为 main.bicep

  4. 将此模板添加到文件的内容。 将<cluster-name><location><username><password>占位符替换为适当的值。

    resource cluster 'Microsoft.DocumentDB/mongoClusters@2025-08-01-preview' = {
      name: '<cluster-name>'
      location: '<location>'
      properties: {
        administrator: {
          userName: '<username>'
          password: '<password>'
        }
        serverVersion: '8.0'
        storage: {
          sizeGb: 32
          type: 'PremiumSSDv2'
        }
        compute: {
          tier: 'M30'
        }
        sharding: {
          shardCount: 1
        }
        highAvailability: {
          targetMode: 'Disabled'
        }
      }
    }
    
  5. 使用 az deployment group create 部署 Bicep 模板。 指定 Bicep 模板的名称,并将占位符替换为 <resource-group> 目标 Azure 资源组的名称。

    az deployment group create \
        --resource-group "<resource-group>" \
        --template-file main.bicep
    
  6. 等待部署完成。 查看部署的输出。

  1. 打开新的终端。

  2. 登录到 Azure CLI。

  3. 创建名为 cluster.json的新 JSON 文件。

  4. 将此文档添加到文件的内容。 请将<location><username><password>占位符替换为相应的值。

    {
      "location": "<location>",
      "properties": {
        "administrator": {
          "userName": "<username>",
          "password": "<password>"
        },
        "serverVersion": "8.0",
        "storage": {
          "sizeGb": 32,
          "type": "PremiumSSDv2"
        },
        "compute": {
          "tier": "M30"
        },
        "sharding": {
          "shardCount": 1
        },
        "highAvailability": {
          "targetMode": "Disabled"
        }
      }
    }
    
  5. az rest使用 Azure CLI 命令创建包含 JSON 文件中指定的配置的新群集。 在请求中将 JSON 文件的名称指定为 body,并替换以下占位符:

    Description
    <subscription-id> 目标 Azure 订阅的唯一标识符
    <resource-group> 目标 Azure 资源组的名称
    <cluster-name> 新 Azure DocumentDB 群集的唯一名称
    az rest \
        --method "GET" \
        --url "https://management.chinacloudapi.cn/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>/users?api-version=2025-08-01-preview" \
        --body @cluster.json
    

    小窍门

    使用 az account show 获取目标 Azure 订阅的唯一标识符。

  6. 等待部署完成。 查看部署的输出。

高性能存储的限制

下面是高性能存储功能的限制:

  • 不支持高可用性 (HA)

  • 不支持副本群集

  • 客户管理的密钥(CMK)不受支持

  • Azure 门户呈现存储大小,但不呈现有效的 IOPS/吞吐量

  • 高性能存储在有限的 Azure 区域中可用

高性能存储的注意事项

在 Azure DocumentDB 群集中使用高性能存储时,请考虑以下事项:

  • 对于每 1 GiB 存储/月的固定价格,高性能存储可以获取所选计算/存储组合的最大性能。 有关详细信息,请参阅 Azure DocumentDB 定价