Ограничение общей пропускной способности, подготовленной в учетной записи Azure Cosmos DB

Статья
04/07/2023

Область применения: Nosql Mongodb Кассандра Гремлин Таблица

При использовании учетной записи Azure Cosmos DB в режиме подготовленной пропускной способности основная часть затрат обычно связана с объемом пропускной способности, подготовленной для учетной записи. В частности, на эти затраты непосредственно влияет следующее:

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

Отслеживать общий объем пропускной способности, подготовленной для вашей учетной записи, может быть непросто, особенно если вы только начинаете работать с Azure Cosmos DB. Это может привести к непредвиденным расходам и превышению выделенного бюджета. Чтобы помочь вам контролировать затраты, Azure Cosmos DB позволяет ограничить общую пропускную способность, подготовленную для вашей учетной записи.

Примечание.

Эта функция недоступна для бессерверных учетных записей.

После настройки ограничения общей пропускной способности учетной записи любая из следующих операций, которая приведет к превышению этого ограничения, блокируется и завершается явным сбоем:

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

Примечание.

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

Внимание

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

Настройка ограничения общей пропускной способности на портале Azure

Новая учетная запись

При создании учетной записи Azure Cosmos DB на портале можно ограничить общую пропускную способность:

Снимок экрана: ограничение общей пропускной способности при создании учетной записи на портале Azure.

Если вы включите этот параметр, общая пропускная способность вашей учетной записи будет ограничена до 1000 ЕЗ/с для учетной записи уровня "Бесплатный и 4000 ЕЗ/с для обычной записи платного уровня. Это значение можно изменить после создания учетной записи.

Имеющаяся учетная запись

На портале Azure перейдите к учетной записи Azure Cosmos DB и выберите Управление затратами в меню слева.

Снимок экрана: обновление общей пропускной способности для существующей учетной записи на портале Azure.

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

Limit the account's total provisioned throughput to the amount included in the free tier discount (Ограничение общей пропускной способности учетной записи до значения, включенного в скидку на основе категории "Бесплатный"). Этот вариант доступен только для учетных записей категории "Бесплатный" и устанавливает ограничение 1000 ЕЗ/с для общей пропускной способности вашей учетной записи. Если выбрать этот параметр плата за подготовленную пропускную способность не взимается.
Разрешить подготовку общей пропускной способности учетной записи до заданного значения. Этот вариант позволяет ввести общую подготовленную пропускную способность, которую вы не хотите превышать. В качестве справки отображается оценка ежемесячных затрат, соответствующая введенному значению.

Примечание.

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

Программная настройка ограничения общей пропускной способности

Использование шаблонов Azure Resource Manager

При создании или обновлении учетной записи Azure Cosmos DB с помощью Azure Resource Manager можно указать ограничение общей пропускной способности с помощью свойства properties.capacity.totalThroughputLimit:

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

Чтобы отключить ограничение, установите для этого свойства значение -1.

Часто задаваемые вопросы

Есть ли ситуации, когда общая подготовленная пропускная способность превышает ограничение?

Azure Cosmos DB обеспечивает минимальную пропускную способность 1 ЕЗ/с на гб хранимых данных. Если вы выполняете прием данных при этом как минимум, пропускная способность, подготовленная на ваших ресурсах, автоматически увеличится до 1 ЕЗ/с за ГБ. Это единственный случай, когда общая пропускная способность может превысить установленное ограничение.

Следующие шаги

Планирование затрат и управление ими в Azure Cosmos DB.
Дополнительные сведения о подготовленной пропускной способности.
Ознакомьтесь со сведениями об оптимизации затрат на подготовленную пропускную способность.

Поделиться через