Ограничения службы 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 см. в обзоре службы: