共用方式為

Microsoft Fabric API 適用於 GraphQL 的限制

本文詳述 Microsoft Fabric 在 GraphQL API 方面的當前限制。

局限性

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

  • 任何利用 SQL 分析端點進行存取的數據源都僅支援對它進行讀取作業。 例如，Lakehouses 或鏡像資料庫無法進行變更。

  • 目前的預設頁尺寸為100，這表示每個請求都會在回應中傳回最多100個元素。 如果您的結果集大於 100，請使用 GraphQL 分頁來遍歷結果。

  • 分頁大小上限為 100,000。 這表示要求將傳回的固定項目數目上限，而且您可以逐一查看。 如果您需要為您的應用程式傳回超過 100K 個元素，請發出多個要求。 瞭解此模式在 GraphQL 中並不常見。

  • 我們支持的回復大小上限為 64MB。 這表示任何回復大小大於 64MB 的 API 要求都傳回錯誤。 若要解決此問題，您可以發出多個篩選的要求。

  • 預存程式的限制（適用於 Azure SQL、網狀架構中的 SQL Database 和數據倉儲）：

    • Api for GraphQL 只會使用預存程式傳回的第一個結果集。
    • 僅支援用 sys.dm_exec_describe_first_result_set 描述的第一個結果集之元數據的預存程序。
    • 當預存程式參數同時在組態檔和 URL 查詢字串中指定時，URL 查詢字串中的參數優先。
    • 使用預存程序的實體並不具備數據表或檢視表所依賴之實體自動具備的所有功能。
    • 由預存程序支持的實體不支援分頁、排序或篩選。 這類實體也不支援傳回由主鍵值指定的項目。

  • 目前的要求逾時設定是100秒。 這表示，如果您發出要求來產生超過100秒才能完成的數據源查詢，您的要求可能會失敗併發生錯誤。

  • 支持的查詢深度上限為 10。 查詢深度是查詢中的欄位巢狀層級，如果因為潛在的遞歸和過度數據擷取而太深，可能會影響效能。

已知問題

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

相關內容

  • Last updated on