Azure Digital Twins 服務限制
下列各節說明 Azure Digital Twins 的服務限制。
注意
此服務的某些區域具有可調整的限制。 這在下表中會以 [可調整？] 欄表示。 若可調整限制，則 [可調整？] 值為 [是]。
如果您的企業需要將可調整的限制或配額提高到預設限制以上，您可以透過開啟支援票證來要求其他資源。
依類型限制
功能限制
下表列出 Azure Digital Twins 的功能限制。
| 區域 | 功能 | 預設限制 | 是否可調整？ |
|---|---|---|---|
| Azure 資源 | 每個訂用帳戶的區域中 Azure Digital Twins 執行個體數目 | 10 | Yes |
| Digital Twins | Azure Digital Twins 執行個體中的對應項數目 | 2,000,000 | Yes |
| 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 | Yes |
| Digital Twins | 可在單一匯入作業 API 作業中匯入的關聯性數目 | 10,000,000 | No |
| Digital Twins | 單一對應項的大小上限 (PUT 或 PATCH 要求中的 JSON 主體大小上限) | 32 KB | No |
| Digital Twins | 要求承載大小上限 | 32 KB | No |
| Digital Twins | 字串屬性值的大小上限 (UTF-8) | 4 KB | No |
| Digital Twins | 屬性名稱的大小上限 | 1 KB | No |
| 路由 | 單一 Azure Digital Twins 執行個體的端點數目 | 6 | No |
| 路由 | 單一 Azure Digital Twins 執行個體的路由數目 | 6 | Yes |
| 模型 | 單一 Azure Digital Twins 執行個體中的模型數目 | 10,000 | Yes |
| 模型 | 可以在單一 API 呼叫中匯入的模型數目 (不使用匯入作業 API) | 250 | No |
| 模型 | 可在單一匯入作業 API 作業中匯入的模型數目 | 10,000 | No |
| 模型 | 單一模型的大小上限 (PUT 或 PATCH 要求中的 JSON 主體大小上限) | 1 MB | No |
| 模型 | 在單一頁面中傳回的項目數 | 100 | No |
| 查詢 | 在單一頁面中傳回的項目數 | 1000 | Yes |
| 查詢 | 查詢中的 AND / OR 運算式數目 |
50 | Yes |
| 查詢 | IN / NOT IN 子句中的陣列項目數 |
50 | Yes |
| 查詢 | 查詢中的字元數 | 8,000 | Yes |
| 查詢 | 查詢中的 JOINS 數目 |
5 | Yes |
速率限制
下表反映不同 API 的速率限制。
| API | 功能 | 預設限制 | 是否可調整？ |
|---|---|---|---|
| 作業 API | 每秒要求數目 | 1 | Yes |
| 作業 API | 同時執行的大量作業數目 (包括匯入和刪除) | 1 | Yes |
| 模型 API | 每秒要求數目 | 100 | Yes |
| Digital Twins API | 每秒讀取要求數目 | 1,000 | Yes |
| Digital Twins API | 每秒修補要求數目 | 1,000 | Yes |
| Digital Twins API | 所有對應項和關聯性每秒的建立/刪除作業數目 | 500 | Yes |
| Digital Twins API | 單一對應項或其傳入/傳出關聯性每秒的建立/更新/刪除作業數目 | 10 | No |
| Digital Twins API | 單一對應項或其傳入/傳出關聯性的未處理作業數目 | 500 | No |
| 查詢 API | 每秒要求數目 | 500 | Yes |
| 查詢 API | 每秒查詢單位 | 4,000 | Yes |
| 事件路由 API | 每秒要求數目 | 100 | Yes |
其他 限制
您可以在 GitHub 的下列規格文件中，找到 Azure Digital Twins 模型 DTDL 文件中的資料類型和欄位限制：Digital Twins 定義語言 (DTDL) - 第 2 版 (英文)。
查詢延遲詳細資料會在查詢語言中加以描述。 您可以在查詢參考文件中找到特定查詢語言功能的限制。
使用限制
達到限制時，超出此限制的任何要求都會受到服務節流，這將導致來自這些要求的 429 錯誤回應。
若要管理節流，以下是使用限制的一些建議。
- 使用重試邏輯。 Azure Digital Twins SDK 會針對失敗的要求實作重試邏輯，因此如果您使用提供的 SDK，這項功能已經內建。 否則，請考慮在您自己的應用程式中實作重試邏輯。 服務會在失敗回應中傳回
Retry-After標頭，您可以使用此標頭來判斷重試前要等候的時間。 - 使用閾值和通知來警告接近限制。 Azure Digital Twins 的某些服務限制有對應的計量，可用於追蹤這些區域的使用方式。 若要設定閾值並在接近閾值時根據任何計量設定警示，請參閱建立新的警示規則中的指示。 若要為未提供計量的其他限制設定通知，請考慮在您自己的應用程式碼中實作此邏輯。
- 大規模部署多個執行個體。 避免發生單一失敗點。 考慮在多個執行個體中有邏輯地 (如依區域或租用戶) 劃分對應項子集，而不是為整個部署的繪製一個大型圖表。
- 如需模型建議來協助您在這些功能限制內運作，請參閱模型工具和最佳做法。
注意
Azure Digital Twins 會自動調整資源，以符合本文所述的速率限制。 在達到這些限制之前，您可能會遇到節流，這是由於內部調整以適應傳入負載。 內部調整可能需要 5 至 30 分鐘的時間，此時您的應用程式可能會遇到 429 錯誤。
下一步
在服務概觀中深入了解 Azure Digital Twins 的目前版本：