共用方式為

在網狀架構中建立 GraphQL 的 API 並新增數據

  • 發行項

注意

適用於 GraphQL 的 Microsoft Fabric API 處於預覽狀態。

藉由建立 API 開始使用適用於 GraphQL 的網狀架構 API，然後鏈接數據源以公開您透過 API 選擇的數據。 網狀架構會根據您的數據自動建置 GraphQL 架構，而應用程式已準備好在幾分鐘內連線。

必要條件

建立 GraphQL 的 API

若要建立 GraphQL 的 API：

  1. 在網狀架構入口網站中，從導覽列底部的工作負載切換器選取 [資料工程師]。 如果您位於 Fabric 首頁，您也可以選取 資料工程師 卡片。

    工作負載切換器中 [資料工程師] 選項的螢幕快照。

  2. 選取 GraphQL 的 API （預覽版）。

    您選取用來建立新 API 專案的 API 圖格螢幕快照。

    或者，從 資料工程師 ing 中的任何工作區選取 [GraphQL 的新>API][預覽]。

    工作區工具列的螢幕快照，其中顯示要選取 [新增] 選項的位置。

  3. 輸入專案的 [ 名稱 ]，然後選取 [ 建立]。

    [GraphQL 新增 API] 對話框的螢幕快照，其中顯示輸入 [名稱] 並選取 [建立]。

您現在有功能完整的 API，可在 Fabric 中存取您的資料。

連線 數據源並建置架構

此時，API 已就緒，但不會公開任何數據。 GraphQL 的 API 定義於以強型別系統中的類型和欄位來組織的架構中。 網狀架構會根據您選擇要公開給 GraphQL 用戶端的數據，自動產生必要的 GraphQL 架構。

  1. 在新的 API 中，選擇 [選取數據源] 來選擇要公開 的數據源。

    [選取資料源] 選項的螢幕快照。

  2. OneLake 數據中樞隨即出現;選擇您要連線的數據來源。 針對下列範例，我們選擇連結至鏡像資料庫的 AdventureWorks SQL 分析端點。 選取 [ 篩選 ] 只查看特定類型的 Fabric 數據源，或依特定關鍵詞搜尋。 當您準備好時，請選取 [連線]。

    OneLake 數據中樞的螢幕快照，其中顯示工作區的可用數據源選項。

  3. [ 取得數據] 畫面隨即出現，您可以在其中選擇要在 GraphQL 架構中公開的物件。

    [取得數據] 畫面的螢幕快照，其中顯示 [選擇數據] 清單。

  4. 選取您要在 API 中公開的個別資料表或預存程式旁的複選框。 若要選取資料夾中的所有物件，請選取頂端具有數據來源名稱的複選框。

    [選擇資料] 列表的螢幕快照，其中已選取資料夾，自動選取該資料夾內的所有專案。

  5. 選取 [載入 ] 以啟動 GraphQL 架構產生程式。

  6. 架構已產生，您可以開始建立 GraphQL 查詢（讀取、清單）或突變（建立、更新、刪除）原型，以與您的數據互動。

    [架構總管] 畫面的螢幕快照。

您的 GraphQL API 現在已準備好接受連線和要求。 您可以使用 API 編輯器來測試和建立 GraphQL 查詢原型，以及架構總管來驗證 API 中公開的數據類型和欄位。

相關內容