尋找適用於 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 Databases
它提供統一的 API 層，以便從這些支援的資料來源查詢和變動資料。
適用於 GraphQL 的 Fabric API 支援哪些 GraphQL 作業？
目前僅支援 GraphQL 查詢 (讀取) 和變動 (寫入)。 透過 SQL 分析端點公開的資料來源是唯讀的，因此僅支持查詢。 對於資料倉儲來說，需要定義一個主鍵，才能自動產生變異。
如何在適用於 GraphQL 的 Fabric API 中檢視和編輯解析程式？
解析程式是 GraphQL 元件，可提供商務邏輯來解析 API 中的欄位，並使用位於資料來源中的資料執行作業。
自動產生： 每當你附加新資料來源或選擇要從現有資料來源暴露的新物件時，Fabric 會自動產生解析器。
客製化： 目前無法直接自訂解析器。 針對適用於 GraphQL 的 API 中的自訂商業規則，您可以在數據源中建立 預存程式 ，並在 GraphQL API 中公開。
GraphQL 用戶端應用程式的 API 是否需要對資料來源的存取權才能執行查詢或變更？
Microsoft Entra ID authentication： API for GraphQL 要求應用程式使用 Microsoft Entra ID 進行認證。 你的客戶端應用程式必須註冊並設定，才能對 Fabric 執行 API 呼叫。
所需權限：
- Microsoft Entra 註冊的應用程式需要 GraphQLApi.Execute.All 權限才能 Power BI 服務。 更多資訊請參閱在 Azure 建立 Microsoft Entra 應用程式。
單一登入（SSO）配置：若 API 設定為使用 SSO，認證使用者或服務主體需同時具有訪問權限：
- GraphQL API（執行查詢與變異 權限）
- 資料來源（根據需要讀取或寫入存取權限）
工作區層級存取選項：或者，將使用者或服務主體指派為工作空間成員，並賦予其 貢獻者角色，使 API 與資料來源項目同時位於此。 這樣就能從同一地點同時access這兩個項目。 欲了解更多資訊，請參閱為用戶授予工作區存取權。
已儲存憑證配置： 若 API 設定為使用已儲存憑證，經過認證的使用者或服務主體只需存取 API（在為 API 添加直接存取權限時，選擇 Run Queries and Mutations選項）。
舉例：你可以在 Connect Applications 找到一個端對端範例，包含使用者主體與服務主體的範例程式碼。
如何為 GraphQL 的 API 開立支援單？
如需有關 GraphQL Fabric API 的問題獲得 Microsoft 支援，請造訪我們的 Fabric 支援網站，並選擇 資料工程 選項。
GraphQL 的 API 支援 Private Link 嗎？
目前 API for GraphQL 僅支援 租戶層級 Private Link。
為什麼我第一次發出請求時，表現不佳，而在後續的請求中表現良好？
這種「冷啟動」行為主要有兩個原因：
資料來源熱身：
- 如果資料來源需要從冷狀態熱起來，第一個請求可能會花更久時間
- 即使資料來源不是冷的，如果資料來源沒有將必要的資料載入記憶體，那麼第一次由 GraphQL 發出查詢時，資料檢索的效率可能不會那麼高。
API 端點初始化：
- 第一次請求 GraphQL 端點的 API 可能會花比較久，因為系統需要載入你的架構和設定
- 後續的請求會比較快，因為系統已經預熱並準備好處理你的請求
您可以在 效能最佳做法中找到詳細資訊。
如何提供 GraphQL API 的意見反應或建議？
歡迎您提供意見反應和建議！ 您可以透過 Fabric Ideas提供意見反應。 我們的小組會主動監視透過此平臺提交的意見反應和建議。 您也可以透過 Microsoft Fabric 支援與我們聯繫，提出任何特定疑問或疑慮。