尋找適用於 GraphQL 的 Fabric API 常見問題的解答。
什麼是 GraphQL？
GraphQL 是 API 的查詢語言，可讓應用程式完全要求所需的數據。 它會使用強型別系統來清楚描述可用的數據、藉由允許精確的要求來減少過度擷取、讓 API 更新更容易，而不會中斷現有的程式代碼，並可讓您使用一組廣泛的開發人員工具。 這是讓應用程式與伺服器和資料庫通訊更有效率的方式。
什麼是適用於 GraphQL 的 Microsoft Fabric API？
Microsoft Fabric API for GraphQL 是一項受控服務，可讓您在數秒內建立 GraphQL API，從數據源存取數據，例如Microsoft網狀架構數據倉儲、Microsoft Fabric Lakehouses、Microsoft網狀架構鏡像資料庫、Microsoft Fabric SQL 資料庫 和 Azure SQL 資料庫。 它提供統一的 API 層，以便從這些支援的資料來源查詢和變動資料。
適用於 GraphQL 的 Fabric API 支援哪些 GraphQL 作業？
目前僅支援 GraphQL 查詢 (讀取) 和變動 (寫入)。 透過 SQL 分析端點公開的資料來源是唯讀的，因此僅支持查詢。 在數據倉儲的情況下，必須定義主要索引鍵，才能自動產生突變。
如何在適用於 GraphQL 的 Fabric API 中檢視和編輯解析程式？
解析程式是 GraphQL 元件，可提供商務邏輯來解析 API 中的欄位，並使用位於資料來源中的資料執行作業。 每當您附加新的資料來源或選取要從現有資料來源公開的新物件時，Fabric 就會自動產生解析程式。 目前無法自訂解析程式。 針對適用於 GraphQL 的 API 中的自訂商業規則，您可以在數據源中建立 預存程式 ，並在 GraphQL API 中公開。
GraphQL 用戶端應用程式的 API 是否需要存取資料來源，才能執行查詢或變動？
適用於 GraphQL 的 API 需要應用程式使用 Microsoft Entra ID 進行驗證。 您必須註冊並設定用戶端應用程式，才能對 Fabric 執行 API 呼叫。 Microsoft 在 Entra 中註冊的應用程式需要 GraphQLApi.Execute.All Power BI 服務的許可權。 如需詳細資訊，請參閱在 Azure 中建立 Microsoft Entra 應用程式。 除了Microsoft Entra 之外，如果 API 設定為使用單一登錄 （SSO），呼叫 GraphQL API 的應用程式中已驗證的使用者或服務主體 需要同時存取 GraphQL API 和數據源。 更具體地說 ，在 GraphQL API 中執行查詢和突變 許可權，以及據以選擇之數據源所需的讀取或寫入許可權。 另一個選項是將使用者或服務主體作為具有 參與者角色的工作區成員， API 和數據源專案所在的位置，這可提供從單一位置存取這兩個專案的必要存取權。 如需詳細資訊，請參閱讓使用者存取工作區。 或者，如果 API 設定為使用已儲存的認證，則已驗證的使用者或服務主體只需要具有 API 的存取權（在將直接存取權限新增至 API 時，選取 [執行查詢和突變] 選項 選項）。 您可以在 Connect Applications 找到一個端對端範例，其中包含用戶主體和服務主體的範例程序代碼。
如何開啟適用於 GraphQL 的 API 的支援票證？
若要從 Microsoft 支援服務取得適用於 GraphQL 的 Fabric API 相關問題的說明，請造訪我們的 Fabric 支援網站，然後選擇 [資料工程] 選項。
GraphQL 的 API 是否支援 Private Link？
適用於 GraphQL 的 API 目前不支援 Private Link。 不過，我們計劃在未來支援這項功能，並會在更新可供使用時提供更新。
我為網狀架構租用戶啟用 Private Link。 為什麼我的 GraphQL 項目無法運作？
如果已啟用 「封鎖公用因特網存取」的租用戶設定（也就是已停用公用存取），則會自動停用任何未移植的成品或專案，包括 GraphQL 的 API。 這表示無法存取先前建立的專案，也無法建立新的專案。 存取這些專案的唯一方法是允許公用存取。
為什麼第一次發出要求時，我的要求執行效能不佳，然後對後續要求執行良好？
此行為有兩個主要原因。 首先，如果數據源很冷，則第一個要求可能需要較長的時間。 即使數據源不是冷的，如果數據源沒有在記憶體中載入必要的數據，數據擷取在 GraphQL 第一次發出查詢時可能沒有效率。 第二個原因是 GraphQL 端點 API 的第一個要求可能需要較長的時間，因為系統必須載入架構和組態，才能接受要求。 這是一次性成本，而且後續的要求速度較快，因為系統已經準備好提供您的要求。 您可以在 效能最佳做法中找到詳細資訊。
如何提供 GraphQL API 的意見反應或建議？
歡迎您提供意見反應和建議！ 您可以透過 Fabric Ideas提供意見反應。 我們的小組會主動監視透過此平臺提交的意見反應和建議。 您也可以透過 Microsoft網狀架構支援 與我們連絡，以取得任何特定查詢或疑慮。