Масштабирование и настройка кластера Azure DocumentDB

Azure DocumentDB обеспечивает бесшовную масштабируемость и высокий уровень доступности в регионе (HA). Этот документ служит кратким руководством для разработчиков, которые хотят узнать, как масштабировать и настраивать кластеры.

Предпосылки

• подписка Azure

  • Если у вас нет подписки Azure, создайте бесплатную учетную запись.

• Существующий кластер Azure DocumentDB

  • Если у вас нет кластера, создайте новый кластер

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".

  

• Если вы предпочитаете запускать справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, подумайте о запуске Azure CLI в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, войдите в Azure CLI с помощью команды az login . Чтобы завершить процесс аутентификации, следуйте шагам, отображаемым в вашем терминале. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".

  • Когда вас попросят, установите расширение Azure CLI при первом использовании. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Масштабирование вычислений кластера

Уровень кластера позволяет настроить количество виртуальных ядер и объем ОЗУ в физических сегментах кластера. Вы можете изменить уровень кластера в соответствии с вашими потребностями в любое время без прерываний. Например, можно увеличить от M50 до M60 или уменьшить M50 до M40.

Портал Azure

1. На боковой панели кластера в разделе "Параметры" выберите "Масштаб".

2. Чтобы изменить уровень кластера, выберите новый уровень в раскрывающемся меню.

   

3. Нажмите кнопку "Сохранить", чтобы сохранить изменения.

Azure CLI

1. Чтобы масштабировать уровень вычислений кластера вверх или вниз, обновите существующий 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>"
   

REST API

Rest API Azure можно использовать напрямую или упаковать в az rest среду Azure CLI.

1. Используйте эту команду для изменения уровня вычислительных ресурсов кластера:

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

   Подсказка

   Если вы используете Azure Cloud Shell, вы можете отправлять и скачивать файлы непосредственно в оболочку. Дополнительные сведения см. в управляемых файлах в Azure Cloud Shell.

Замечание

Переход с обычного уровня вычислений на ресурсоемкий уровень не поддерживается.

Увеличьте размер хранилища.

Вы можете увеличить размер хранилища , чтобы предоставить базе данных больше места для роста. Например, можно увеличить хранилище с 128 ГиБ до 256 ГиБ.

Портал Azure

1. Чтобы увеличить размер хранилища, выберите новый размер в раскрывающемся меню.

   

2. Нажмите кнопку "Сохранить", чтобы сохранить изменения.

Azure CLI

1. Чтобы увеличить размер хранилища кластера, обновите существующий 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>"
   

REST API

Rest API Azure можно использовать напрямую или упаковать в az rest среду Azure CLI.

1. Используйте эту команду для изменения уровня вычислительных ресурсов кластера:

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

   Подсказка

   Если вы используете Azure Cloud Shell, вы можете отправлять и скачивать файлы непосредственно в оболочку. Дополнительные сведения см. в управляемых файлах в Azure Cloud Shell.

Это важно

Размер хранилища можно увеличить только, а не уменьшить.

Включение или отключение высокой доступности

Вы можете включить или отключить высокий уровень доступности в регионе в соответствии с вашими потребностями. Высокий уровень доступности в регионе позволяет избежать простоя базы данных, сохраняя сегменты реплик каждого первичного сегмента в кластере. Если основной сегмент выходит из строя, входящие подключения автоматически перенаправляются на сегмент реплики, обеспечивая минимальное время простоя.

Портал Azure

1. Чтобы включить или отключить высокий уровень доступности в регионе, установите флажок.

   

2. Нажмите кнопку "Сохранить", чтобы сохранить изменения.

Azure CLI

1. Чтобы включить высокий уровень доступности в регионе в кластере, обновите существующий кластер update операцией, задав значение в свойстве highAvailability.targetModeZoneRedundantPreferred.

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

2. Чтобы отключить высокий уровень доступности в регионе в кластере, обновите существующий кластер update операцией, задав для свойства highAvailability.targetModeзначение Disabled .

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

REST API

Rest API Azure можно использовать напрямую или упаковать в az rest среду Azure CLI.

1. Используйте эту команду, чтобы включить высокий уровень доступности в регионе в кластере:

   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. Эта команда позволяет отключить высокий уровень доступности в регионе в кластере:

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

Увеличение числа физических сегментов

Если база данных выходит за рамки емкости одного физического кластера сегментов, можно увеличить размер хранилища или добавить больше физических сегментов. После добавления нового физического сегмента в кластер необходимо выполнить операцию перебалансирования кластера для распространения данных по сегментам. Каждый физический сегмент в кластере всегда имеет одинаковую конфигурацию вычислений и хранилища .

Портал Azure

1. Чтобы добавить физические сегменты, выберите новое количество сегментов из списка.

   

2. Нажмите кнопку "Сохранить", чтобы сохранить изменения.

3. Нажмите кнопку "Продолжить " во всплывающем окне, чтобы сохранить изменения.

Azure CLI

1. Чтобы добавить физический сегмент в кластер, обновите существующий кластер update операцией, увеличив значение свойства 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>"
   

   Замечание

   За раз можно добавить только один физический сегмент. Если необходимо добавить в кластер несколько физических сегментов, необходимо выполнить его последовательно.

REST API

Rest API Azure можно использовать напрямую или упаковать в az rest среду Azure CLI.

1. Используйте эту команду для добавления физического сегмента в кластер:

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

   Замечание

   За раз можно добавить только один физический сегмент. Если необходимо добавить в кластер несколько физических сегментов, необходимо выполнить его последовательно.

Подсказка

Если в кластере требуется более 10 физических сегментов, откройте запрос в службу поддержки.

Перебалансировать данные

После добавления физического сегмента в кластер или при неравномерном использовании хранилища в нескольких сегментах данные повторно распределяются между сегментами без простоя.

В предварительной версии необходимо включить перебалансирование данных в кластере:

1. На портале Azure откройте свойства кластера.
2. В разделе "Параметры" на странице "Компоненты" выберите rebalancer для кластеров с несколькими сегментами.
3. На панели " Перебалансировщик для кластеров с несколькими сегментами " нажмите кнопку "Включить".

Чтобы инициировать перебалансирование данных, подключитесь к кластеру с помощью средства управления, например оболочки Mongo.

1. Запустите перебалансировщик командой sh.startBalancer().

2. Проверьте состояние перебалансировщика с помощью sh.isBalancerRunning().

3. Остановите перебалансировщик командой sh.stopBalancer().

Замечание

Длительность процесса перебалансирования зависит от объема перемещаемых данных между физическими сегментами. Операция выполняется в сети и не влияет на доступность кластера или функциональные возможности.

Дальнейшие шаги

В этом руководстве мы показали, что масштабирование и настройка кластера Azure DocumentDB на портале Azure является простым процессом. Портал Azure включает возможность настраивать уровень кластера, увеличивать размер хранилища, включать или отключать высокий уровень доступности и добавлять физические сегменты без простоя.

• Варианты вычислительных ресурсов и хранилищ
• Ознакомьтесь с основами сегментирования

Восстановление кластера Azure DocumentDB