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


Ограничения службы Azure Digital Twins

В следующих разделах описываются ограничения службы Azure Digital Twins.

Примечание.

Для некоторых областей этой службы предусмотрены регулируемые ограничения. Они представлены в приведенных ниже таблицах со столбцом Adjustable? (Регулируемый?). Если ограничение можно изменить, в столбце Регулируется? будет указано значение Да.

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

Ограничения по типу

Функциональные ограничения

В следующей таблице перечислены функциональные ограничения для Azure Digital Twins.

Площадь Возможность Ограничение по умолчанию Настраивается?
Ресурс Azure Количество экземпляров Azure Digital Twins в регионе на подписку 10 Да
Digital Twins Количество двойников в экземпляре Azure Digital Twins 2 000 000 Да
Digital Twins Число цифровых двойников, которые можно импортировать в одном задании API заданий импорта 2 000 000 No
Digital Twins Количество входящих связей для одного двойника 50,000 No
Digital Twins Количество исходящих связей от одного двойника 50,000 No
Digital Twins Общее количество связей в экземпляре Azure Digital Twins 20 000 000 Да
Digital Twins Количество связей, которые можно импортировать в одном задании API заданий импорта 10 000 000 No
Digital Twins Максимальный размер (тела JSON в запросе PUT или PATCH) для одного двойника 32 КБ No
Digital Twins Максимальный объем полезных данных в запросе 32 КБ No
Digital Twins Максимальный размер строкового значения свойства (UTF-8) 4 КБ No
Digital Twins Максимальный размер имени свойства 1 КБ No
Маршрутизация Количество конечных точек для одного экземпляра Azure Digital Twins 6 No
Маршрутизация Количество маршрутов для одного экземпляра Azure Digital Twins 6 Да
Модели Количество моделей в одном экземпляре Azure Digital Twins 10,000 Да
Модели Количество моделей, которые можно импортировать в один вызов API (не с помощью API импорта заданий) 250 No
Модели Количество моделей, которые можно импортировать в одном задании API заданий импорта 10,000 No
Модели Максимальный размер (тела JSON в запросе PUT или PATCH) для одной модели 1 МБ No
Модели Количество элементов, возвращаемых на одной странице 100 No
Query Количество элементов, возвращаемых на одной странице 1000 Да
Query Количество выражений AND / OR в запросе 50 Да
Query Количество элементов массива в предложении IN / NOT IN 50 Да
Query Количество символов в запросе 8000 Да
Query Количество JOINS в запросе 5 Да

Ограничения скорости

В следующей таблице представлены ограничения на количественные характеристики различных API-интерфейсов.

API Возможность Ограничение по умолчанию Настраивается?
API заданий Количество запросов в секунду 1 Да
API заданий Число массовых заданий, выполняющихся одновременно (включая импорт и удаление) 1 Да
API-интерфейсы моделей Количество запросов в секунду 100 Да
API-интерфейс Digital Twins Количество запросов на чтение в секунду 1,000 Да
API-интерфейс Digital Twins Количество запросов на исправление в секунду 1,000 Да
API-интерфейс Digital Twins Количество операций создания/удаления в секунду для всех двойников и связей 500 Да
API-интерфейс Digital Twins Количество операций создания, обновления и удаления в секунду для одного двойника или его входящих и исходящих связей 10 No
API-интерфейс Digital Twins Количество незавершенных операций для одного двойника или его входящих и исходящих связей 500 No
API запроса Количество запросов в секунду 500 Да
API запроса Количество единиц запросов в секунду 4000 Да
API-интерфейс маршрутизации событий Количество запросов в секунду 100 Да

Другие ограничения

Ограничения на типы данных и поля в документах DTDL для моделей Azure Digital Twins можно найти в документации с техническими характеристиками на сайте GitHub: Digital Twins Definition Language (DTDL) — версия 2.

Сведения о задержке запросов см. в разделе Язык запросов. Описание ограничений конкретных функций языка запросов см. в справочной документации по запросам.

Работа с ограничениями

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

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

  • Использование логики повторных попыток. Пакеты SDK Azure Digital Twins реализуют логику повторных попыток для неудачных запросов. Поэтому, если вы работаете с предоставленным пакетом SDK, эта возможность уже встроена. В противном случае мы рекомендуем реализовать логику повторных попыток в своем приложении. Служба отправляет заголовок Retry-After в ответе на сбой, который можно использовать для определения времени ожидания перед повторной попыткой.
  • Используйте пороговые значения и уведомления, чтобы предупредить об ограничениях, которые скоро будут достигнуты. Некоторые из ограничений службы Azure Digital Twins имеют соответствующие метрики, которые можно использовать для отслеживания использования в этих областях. Чтобы настроить пороговые значения и настроить оповещение по любой метрике при приближении к пороговому значению, см. инструкции в статье "Создание нового правила генерации оповещений". Чтобы настроить уведомления о других ограничениях, которые не предоставляются метриками, рассмотрите возможность реализации этой логики в собственном коде приложения.
  • Развертывание в масштабе в нескольких экземплярах. Избегайте одной точки сбоя. Вместо одного большого графа для всего развертывания мы рекомендуем разделять подмножества двойников логически (например, по регионам или клиентам) в нескольких экземплярах.
  • Рекомендации по моделированию, которые помогут вам работать в функциональных ограничениях, см. в статье "Инструменты моделирования" и рекомендации.

Примечание.

Azure Digital Twins автоматически масштабирует ресурсы для удовлетворения ограничений скорости, описанных в этой статье. Вы можете столкнуться с регулированием до достижения этих ограничений из-за внутреннего масштабирования для адаптации к входящей нагрузке. Внутреннее масштабирование может занять от 5 до 30 минут, в течение которого приложение может столкнуться с 429 ошибками.

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

Дополнительные сведения о текущем выпуске Azure Digital Twins см. в обзоре службы: