共用方式為

Microsoft Fabric API 適用於 GraphQL 的限制

本文列出 Microsoft Fabric 中適用於 GraphQL 之 API 的目前一般產品限制。 我們持續改進 GraphQL 的 API，加入新功能。 如需Microsoft網狀架構未來的詳細資訊，請參閱 網狀架構藍圖。

誰需要瞭解這些限制

了解 GraphQL API 的限制對於以下事項至關重要：

  • 設計應用程式以符合 Fabric GraphQL API 限制的開發者
  • 資料工程師 規劃資料暴露策略並理解平台邊界
  • 解決方案架構師 負責界定基於 Fabric 的解決方案範圍並設定適當的技術期望
  • Fabric 工作區貢獻者協助 排查問題並實施解決當前限制的變通方法
  • 專案經理 在專案規劃期間向利害關係人傳達 Fabric 平台的限制

在規劃 GraphQL API 實作或排除意外 API 行為時，請檢視這些限制。

資料來源操作

SQL Analytics 端點資料來源 僅支援讀取操作。 透過 SQL Analytics 端點存取的資料來源（例如湖屋和鏡像資料庫）不支援變異。 你可以查詢資料，但無法透過 GraphQL API 建立、更新或刪除紀錄。

尺寸與性能限制

下表總結了金鑰大小、分頁及效能限制：

限制類型 價值觀 Description 因應措施
默認頁面大小 100件物品 預設每個請求回傳的最大項目數 使用 GraphQL 分頁 來遍歷較大的結果集
最大頁碼大小 100,000 個項目 可透過分頁檢索的最大項目總數 如果你需要超過 10 萬個項目，就發出多個篩選請求（這是 GraphQL 中不常見的模式）
回應大小上限 64 MB API 回應有效載荷的最大大小 發送多個過濾請求，以更小的區塊取得資料
要求逾時 100 秒 單一請求的最大執行時間 優化查詢或將複雜操作拆解成較小的請求
最大查詢深度 10 層 查詢中欄位的最大巢狀層級 減少查詢巢狀，以避免過度資料擷取導致效能問題

儲存過程的限制

Azure SQL、Fabric 中的 SQL 資料庫及資料倉儲中的儲存程序有特定的限制：

  • 結果集處理：僅使用儲存程序回傳的第一個結果集。 不支援多重結果集。
  • 元資料需求：僅支援第一個結果集之元資料能夠被sys.dm_exec_describe_first_result_set描述的儲存程序。
  • 參數優先順序：當儲存程序參數同時在設定檔與 URL 查詢字串中指定時，URL 查詢字串值會優先。
  • 有限的 GraphQL 功能：由儲存程序支持的實體相比於以表格或檢視為基礎的實體，功能較受限：
    • 無分頁支援
    • 沒有排序或過濾
    • 沒有基於主鍵的查詢

已知問題

如需 GraphQL API 中的已知問題，請瀏覽 Microsoft Fabric 已知問題。

相關內容

  • Last updated on