你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure 数字孪生服务限制
以下部分介绍 Azure 数字孪生的服务限制。
注意
此服务的限制在某些区域可调整。 下表的“可调整?”列中进行了相关描述。 当限制可调整时，“可调整?”的值为“是” 。
如果你的业务需要将可调整的限制或配额提高到默认限制之上，可以通过创建支持票证来请求更多资源。
按类型列出的限制
功能限制
下表列出了 Azure 数字孪生的功能限制。
| 区域 | 功能 | 默认限制 | 可调？ |
|---|---|---|---|
| Azure 资源 | 区域中每个订阅的 Azure 数字孪生实例数 | 10 | 是 |
| 数字孪生 | Azure 数字孪生实例中的孪生体数 | 2,000,000 | 是 |
| 数字孪生 | 可在单个导入作业 API 作业中导入的数字孪生体数 | 2,000,000 | 否 |
| 数字孪生 | 单个孪生体的传入关系数 | 50,000 | 否 |
| 数字孪生 | 单个孪生体的传出关系数 | 50,000 | 否 |
| 数字孪生 | Azure 数字孪生实例中关系的总数 | 20,000,000 | 是 |
| 数字孪生 | 可在单个导入作业 API 作业中导入的关系数 | 10,000,000 | 否 |
| 数字孪生 | 单个孪生体的（PUT 或 PATCH 请求中的 JSON 正文的）最大大小 | 32 KB | 否 |
| 数字孪生 | 请求有效负载最大大小 | 32 KB | 否 |
| 数字孪生 | 字符串属性值的最大大小 (UTF-8) | 4 KB | 否 |
| 数字孪生 | 属性名称的最大大小 | 1 KB | 否 |
| 路由 | 单个 Azure 数字孪生实例的终结点数 | 6 | 否 |
| 路由 | 单个 Azure 数字孪生实例的路由数 | 6 | 是 |
| 模型 | 单个 Azure 数字孪生实例中的模型数 | 10,000 | 是 |
| 模型 | 可在单个 API 调用中导入的模型数（不使用 导入作业 API） | 250 | 否 |
| 模型 | 可在单个导入作业 API 作业中导入的模型数 | 10,000 | 否 |
| 模型 | 单个模型的（PUT 或 PATCH 请求中的 JSON 正文的）最大大小 | 1 MB | 否 |
| 模型 | 单个页面中返回的项数 | 100 | 否 |
| 查询 | 单个页面中返回的项数 | 1000 | 是 |
| 查询 | 查询中 AND / OR 表达式的数目 |
50 | 是 |
| 查询 | IN / NOT IN 子句中的数组项数 |
50 | 是 |
| 查询 | 查询中的字符数 | 8,000 | 是 |
| 查询 | 查询中的 JOINS 数 |
5 | 是 |
速率限制
下表反映了各种 API 的速率限制。
| API | 功能 | 默认限制 | 可调？ |
|---|---|---|---|
| 作业 API | 每秒请求数 | 1 | 是 |
| 作业 API | 并发运行的批量作业数（包括导入和删除） | 1 | 是 |
| 模型 API | 每秒请求数 | 100 | 是 |
| 数字孪生 API | 每秒读取请求数 | 1,000 | 是 |
| 数字孪生 API | 每秒 PATCH 请求数 | 1,000 | 是 |
| 数字孪生 API | 每秒所有孪生体和关系上创建/删除操作的数量 | 500 | 是 |
| 数字孪生 API | 每秒单个孪生体或其传入/传出关系上创建/更新/删除操作的数量 | 10 | 否 |
| 数字孪生 API | 单个孪生体或其传入/传出关系上的未处理操作数 | 500 | 否 |
| 查询 API | 每秒请求数 | 500 | 是 |
| 查询 API | 查询单元数/秒 | 4,000 | 是 |
| 事件路由 API | 每秒请求数 | 100 | 是 |
其他限制
有关 Azure 数字孪生模型的 DTDL 文档中数据类型和字段的限制，可参阅 GitHub 中的相应规范文档：数字孪生定义语言 (DTDL) - 版本 2。
有关查询延迟的详细信息，请参阅查询语言。 可以在查询引用文档中找到特定查询语言功能的限制。
处理限制
当达到某个限制时，服务将限制任何超出该限制的请求，这会导致这些请求返回 429 错误响应。
若要对此限制进行管理，下面是一些用于处理限制的建议。
- 使用重试逻辑。 Azure 数字孪生 SDK 针对失败请求实现重试逻辑，因此如果你使用的是提供的 SDK，则此功能已内置其中。 否则请考虑在自己的应用程序中实现重试逻辑。 服务在失败响应中发送回
Retry-After标头，可用于确定重试之前要等待的时间。 - 使用阈值和通知就接近限制发出警告。 Azure 数字孪生的一些服务限制具有相应的指标，可用于跟踪这些领域的使用情况。 若要在达到阈值时配置阈值并针对任何指标设置警报，请参阅创建新的警报规则中的说明。 若要为不提供指标的其他限制设置通知，请考虑在自己的应用程序代码中实现此逻辑。
- 跨多个实例大规模部署。 避免出现单一故障点。 考虑跨多个实例按逻辑（例如按区域或租户）划分孪生体的子集，而不是将整个部署视为一个大大的整体。
- 有关建模建议，帮助你在功能限制内运行，请参阅 建模工具和最佳做法。
注意
Azure 数字孪生将自动缩放资源以满足本文中所述的速率限制。 因为系统会为适应传入负载而进行内部缩放，所以可能会在达到这些限制之前遇到限制。 内部缩放可能需要 5 到 30 分钟，在此期间，应用程序可能会遇到 429 错误。
后续步骤
在“服务概述”中详细了解 Azure 数字孪生的最新版本：