共用方式為


在網狀架構中建立 GraphQL 的 API 並新增資料

注意

適用於 GraphQL 的網狀架構 API Microsoft處於預覽狀態。

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

必要條件

建立 GraphQL 的 API

建立適用於 GraphQL 的 API:

  1. 從 [網狀架構入口網站] 首頁,從工作負載清單中選取 [資料工程師]。

  2. 選取 GraphQL 的 API(預覽版)。

    您選取用來建立新 API 項目的 API 圖格螢幕擷取畫面。

    或者,從資料工程中的任何工作區選取 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 中公開的資料類型和欄位。