尋找適用於 GraphQL 的 Fabric API 常見問題的解答。
什麼是 GraphQL？
GraphQL 是 API 的查詢語言，可讓應用程式完全要求所需的數據。 主要優點包括：
- 強型別系統 - 清楚描述可用資料
- 精確資料擷取 ——透過允許特定請求來減少過度取用
- 向下相容性 - 讓 API 更新更容易，且不會破壞現有程式碼
- 豐富工具 - 允許使用廣泛的開發工具
這是讓應用程式與伺服器和資料庫通訊更有效率的方式。
什麼是適用於 GraphQL 的 Microsoft Fabric API？
Microsoft Fabric API for GraphQL 是一項管理服務，讓你能在幾秒內建立 GraphQL API。
支援的資料來源：
- Microsoft Fabric 資料倉儲
- Microsoft Fabric 湖屋
- Microsoft Fabric 鏡像資料庫
- Microsoft Fabric SQL 資料庫
- Azure SQL 資料庫
它提供統一的 API 層，以便從這些支援的資料來源查詢和變動資料。
適用於 GraphQL 的 Fabric API 支援哪些 GraphQL 作業？
目前僅支援 GraphQL 查詢 (讀取) 和變動 (寫入)。 透過 SQL 分析端點公開的資料來源是唯讀的，因此僅支持查詢。 對於資料倉儲來說，需要定義一個主鍵，才能自動產生變異。
如何在適用於 GraphQL 的 Fabric API 中檢視和編輯解析程式？
解析程式是 GraphQL 元件，可提供商務邏輯來解析 API 中的欄位，並使用位於資料來源中的資料執行作業。
自動產生： 每當你附加新資料來源或選擇要從現有資料來源暴露的新物件時，Fabric 會自動產生解析器。
客製化： 目前無法直接自訂解析器。 針對適用於 GraphQL 的 API 中的自訂商業規則，您可以在數據源中建立 預存程式 ，並在 GraphQL API 中公開。
GraphQL 用戶端應用程式的 API 是否需要存取資料來源，才能執行查詢或變動？
Microsoft Entra ID 認證： GraphQL 的 API 要求應用程式使用 Microsoft Entra ID 進行認證。 你的客戶端應用程式必須註冊並設定，才能對 Fabric 執行 API 呼叫。
所需權限：
- Microsoft 在 Entra 中註冊的應用程式需要 GraphQLApi.Execute.All Power BI 服務的許可權。 如需詳細資訊，請參閱在 Azure 中建立 Microsoft Entra 應用程式。
單一登入（SSO）配置： 若 API 設定為使用 SSO，認證使用者或服務主體 需同時存取 ：
- GraphQL API（執行查詢與變異 權限）
- 資料來源（視需要讀寫權限）
工作區層級存取選項： 或者，將使用者或服務主體指派為工作空間成員，並擁有貢獻 者角色 ，該角色同時包含 API 與資料來源項目。 這樣就能同時從一個地方存取這兩個項目。 如需詳細資訊，請參閱讓使用者存取工作區。
儲存憑證設定： 如果 API 設定為使用儲存的憑證，已認證的使用者或服務主體只需存取該 API（在新增直接存取權限時，選擇 執行查詢與變異 選項）。
舉例：你可以在 Connect Applications 找到一個端對端範例，包含使用者主體與服務主體的範例程式碼。
如何開啟適用於 GraphQL 的 API 的支援票證？
若要從 Microsoft 支援服務取得適用於 GraphQL 的 Fabric API 相關問題的說明，請造訪我們的 Fabric 支援網站，然後選擇 [資料工程] 選項。
GraphQL 的 API 是否支援 Private Link？
適用於 GraphQL 的 API 目前不支援 Private Link。
為什麼第一次發出要求時，我的要求執行效能不佳，然後對後續要求執行良好？
這種「冷啟動」行為主要有兩個原因：
資料來源熱身：
- 如果資料來源需要從冷狀態熱起來，第一個請求可能會花更久時間
- 即使資料來源不是冷的，如果資料來源沒有將必要的資料載入記憶體，那麼第一次由 GraphQL 發出查詢時，資料檢索的效率可能不會那麼高。
API 端點初始化：
- 第一次請求 GraphQL 端點的 API 可能會花比較久，因為系統需要載入你的架構和設定
- 後續的請求會比較快，因為系統已經預熱並準備好處理你的請求
您可以在 效能最佳做法中找到詳細資訊。
如何提供 GraphQL API 的意見反應或建議？
歡迎您提供意見反應和建議！ 您可以透過 Fabric Ideas提供意見反應。 我們的小組會主動監視透過此平臺提交的意見反應和建議。 您也可以透過 Microsoft網狀架構支援 與我們連絡，以取得任何特定查詢或疑慮。