共用方式為


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 的目前版本: