Azure Digital Twins 服務限制
下列各節說明 Azure Digital Twins 的服務限制。
注意
此服務的某些區域有可調整的限制。 下表中 會以 [可調整？ ] 資料行來表示。 當可以調整限制時， [可調整？] 值為 [是 ]。
如果您的企業需要提高高於預設限制的可調整限制或配額，您可以開啟支援票證 來要求其他資源 。
依類型限制
功能限制
下表列出 Azure Digital Twins 的功能限制。
| 面積 | 功能 | 預設限制 | 是否可調整？ |
|---|---|---|---|
| Azure 資源 | 每個訂用帳戶區域中的 Azure Digital Twins 實例數目 | 10 | Yes |
| 數位對應項 | Azure Digital Twins 實例中的對應項數目 | 2,000,000 | Yes |
| 數位對應項 | 可在單 一匯入作業 API 作業中匯入的數位對應項數目 | 2,000,000 | No |
| 數位對應項 | 單一對應項的連入關聯性數目 | 50,000 | No |
| 數位對應項 | 單一對應項的傳出關聯性數目 | 50,000 | No |
| 數位對應項 | Azure Digital Twins 實例中的關聯性總數 | 20,000,000 | Yes |
| 數位對應項 | 可以在單 一匯入作業 API 作業中匯入的關聯性數目 | 10,000,000 | No |
| 數位對應項 | 單一對應項的大小上限（PUT 或 PATCH 要求中的 JSON 主體） | 32 KB | No |
| 數位對應項 | 要求承載大小上限 | 32 KB | No |
| 數位對應項 | 字串屬性值的大小上限 （UTF-8） | 4 KB | No |
| 數位對應項 | 屬性名稱的大小上限 | 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： Digital Twins 定義語言 （DTDL） - 第 2 版的規格檔中找到 Azure Digital Twins 模型 DTDL 檔中的資料類型和欄位限制。
查詢延遲詳細資料會以 查詢語言 描述。 您可以在查詢參考檔中 找到 特定查詢語言功能的限制。
使用限制
達到限制時，服務會節流超出它的任何要求，這會導致來自這些要求的 429 錯誤回應。
若要管理節流，以下是使用限制的一些建議。
- 使用重試邏輯。 Azure Digital Twins SDK 會 針對失敗的要求實作重試邏輯，因此，如果您使用提供的 SDK，則此功能已內建。 否則，請考慮在您自己的應用程式中實作重試邏輯。 服務會在失敗回應中傳回
Retry-After標頭，您可以使用此標頭來判斷重試之前要等候的時間。 - 使用臨界值和通知來警告接近限制。 Azure Digital Twins 的某些服務限制有對應的 計量 ，可用來追蹤這些領域的使用量。 若要設定臨界值，並在接近閾值時在任何計量上設定警示，請參閱建立新的警示規則 中的 指示。 若要為未提供計量的其他限制設定通知，請考慮在您自己的應用程式程式碼中實作此邏輯。
- 大規模部署多個實例。 避免發生單一失敗點。 請考慮在多個實例之間以邏輯方式區隔對應項子集（例如依區域或租使用者），而不是整個部署的一個大型圖表。
- 如需模型化建議，以協助您在功能限制內運作，請參閱 模型化工具和最佳做法 。
注意
Azure Digital Twins 會自動調整資源，以符合本文所述的速率限制。 在達到這些限制之前，您可能會遇到節流，因為內部調整以適應傳入負載。 內部調整可能需要 5 到 30 分鐘，在此期間您的應用程式可能會發生 429 錯誤。
下一步
在服務概觀中深入瞭解 Azure Digital Twins 的目前版本：