Microsoft Fabric 中圖形的快速入門指南

備註

這項功能目前處於公開預覽狀態。 此預覽版是在沒有服務等級協定的情況下提供，不建議用於生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

在本快速入門中，您將瞭解如何在 Microsoft Fabric 中建立圖形模型。

這很重要

本文僅使用 AdventureWorks範例圖資料集。

先決條件

若要開始使用 Microsoft Fabric 中的圖形，您需要下列必要條件：

• Graph 在您所在 的地區可用。

• Graph 已在您的 Fabric 租戶中啟用。

  

• OneLake 中的 Lakehouse ，其中包含您想要分析的資料。 本快速入門使用 Adventure Works 資料作為範例。 您的資料和結果可能會有所不同。 如果你還沒有湖屋，請依照以下步驟建立，並確保取消選擇湖屋結構選項： 用 OneLake 建立湖屋。

  這很重要

  你目前無法使用已啟用 lakehouse schema (預覽) 的湖倉。

• 你是工作區的成員，或有權限在工作區中建立項目。 如需詳細資訊，請參閱 Microsoft Fabric 中的工作區。

  這很重要

  圖的存取管理僅限於承載該圖的工作區。 工作區外部的使用者無法存取圖表。 工作空間內有權限存取湖屋底層資料的使用者，可以對圖形進行建模與查詢。

建立圖形模型

若要在 Microsoft Fabric 中建立圖形模型，請遵循下列步驟：

1. 移至您的 Microsoft Fabric 工作區。

2. 選取 + 新增項目。

3. 選擇 分析和訓練資料>Graph 模型（預覽版）。

   

   小提示

   或者，在搜尋框中輸入「圖表」，然後按 Enter 鍵搜尋圖表項目。

4. 輸入圖形模型的名稱，然後選取 [建立]。

建立圖表

在圖形檢視中，您應該會看到 [儲存]、[ 新增節點] 和 [新增邊緣] 和 [ 取得資料 ] 按鈕。

若要在 Microsoft Fabric 中建立圖形，請遵循下列步驟：

1. 在您的圖形模型中，選取 [ 取得資料]。

2. 從 OneLake 目錄中，從 Fabric 中選取要在圖形中使用的資料。

   

   備註

   本快速入門使用 Adventure Works 資料作為範例。 您的資料集和結果可能會有所不同。

3. 然後選取 [Connect]。

4. 選取資料表，然後選取載入。

5. 您應該會在圖表中看到可供使用的資料。

   

   備註

   Microsoft Fabric 中的圖形目前支援下列資料類型：

   • 布林值 （值為 true 和 false）
   • Double（值為64位浮點數）
   • 整數 （值為 64 位元有正負號整數）
   • 字串 （值是 Unicode 字串）
   • 分區日期時間 （值是時間戳記以及時區的時移）

開始建模

現在，您可以透過將節點和邊新增至圖形來開始建模。 我們使用 Adventure Works 資料模型作為範例。

新增節點

在本節中，我們會為 Adventure Works 資料模型中的每個實體建立節點。

節點標籤	映射表	對應欄
客戶	customers	CustomerID_K
訂單	orders	SalesOrderDetailID_K
員工	employees	EmployeeID_K
Product	products	ProductID_K
產品類別	產品類別	CategoryID_K
產品子類別	產品子類別	SubcategoryID_K (子類別識別碼_K)
供應商	vendors	VendorID_K

若要將節點新增至圖表，請遵循下列步驟：

1. 在您的圖形模型中，選取 [ 新增節點 ] 以將新節點新增至圖形。

2. 在 [將節點新增至圖形 ] 對話方塊中，輸入 [標籤名稱] ，然後選取適當的 [對應] 表格 和 [對應] 欄。

   

   在此範例中，節點標籤為「Customer」，對應表為「customers」，對應欄為「CustomerID_K」。

3. 選取 [確認] 以將節點新增至您的圖表。

4. 對所有其他節點重複此過程。 您應該會看到圖表中表示的所有節點。

5. 選取 [儲存] 以開始產生圖表。

   

新增邊緣

在本節中，我們會建立邊緣來定義 Adventure Works 資料模型中節點之間的關聯性。

Edge	映射表	來源節點映射欄位	目標節點對應列
銷售	orders	員工 EmployeeID_FK	訂單 SalesOrderDetailID_K
購買	orders	客戶 CustomerID_FK	訂單 SalesOrderDetailID_K
contains	orders	訂單 SalesOrderDetailID_K	Product ProductID_FK
isOfType	products	Product ProductID_K	產品子類別 SubcategoryID_FK
隸屬於	產品子類別	產品子類別 SubcategoryID_K (子類別識別碼_K)	產品類別 CategoryID_FK
生產	供應商產品	供應商 VendorID_FK	Product ProductID_FK

若要將邊緣新增至圖表，請遵循下列步驟：

1. 選取 [新增邊緣 ] 以建立節點之間的關聯性。

2. 在 「新增邊緣 」對話方塊中，選取對應表格、來源和目標節點，然後定義關係。

   

   在此範例中，邊緣定義為「sells」，對應表為「orders」，將來源節點「Employee」（EmployeeID_FK）連線到目標節點「Order」（SalesOrderDetailID_K）。

3. 選取 [確認] 以將邊緣新增至您的圖表。

4. 對所有其他邊重複此過程。 您應該會看到圖表中表示的所有邊緣。

   

此時，您已建立圖形的所有節點和邊緣。 這些節點和邊就是你圖模型的基本結構。

載入圖表

要載入圖表，請選擇 儲存。 選擇 儲存 後，會驗證圖模型，載入 OneLake 的資料，建構圖，並準備查詢。

這很重要

目前你必須在模型或底層資料變更時重新載入（選擇 儲存）。

查詢圖表

使用查詢產生器

現在，我們可以透過選擇特定的節點和關係來查詢圖。 所有查詢都是基於 我們在上一節中構建的圖形結構。

請依照下列步驟切換至查詢產生器，並開始以互動方式查詢您的圖表：

1. 從圖表的首頁選取 [模式>查詢產生器 ]。 從這個視角，你也可以建立一個唯讀查詢集，功能與下方相同，並允許你分享查詢結果。

2. 選取 [ 新增節點 ] 以查看可用於查詢的節點。

3. 選取節點以將其新增至您的查詢。 在此範例中，我們新增 Customer 節點。

   

4. 從這裡，您可以新增節點和邊緣、套用篩選器，以及選取要在結果中傳回的屬性來建置查詢。

使用程式碼編輯器

我們也可以使用圖形查詢語言（GQL）查詢該圖。

請依照下列步驟切換至程式碼編輯器，並開始使用 GQL 查詢圖表：

1. 從圖表的首頁選取 模式>程式碼編輯器 。
2. 在輸入欄位中輸入 GQL 查詢，例如 MATCH (n:`Order`) RETURN count(n) AS num_orders。
3. 選取 [執行查詢] 以執行查詢。

您也可以執行更複雜的查詢，例如結合相符圖形模式、篩選、彙總、排序和 top-k 限制的查詢：

MATCH (v:Vendor)-[:produces]->(p:`Product`)->(sc:`ProductSubcategory`)->(c:`ProductCategory`), 
      (o:`Order`)-[:`contains`]->(p)
FILTER c.categoryName = 'Components'
LET vendorName = v.vendorName, subCategoryName = sc.subCategoryName
RETURN vendorName, subCategoryName, count(p) AS num_products, count(o) AS num_orders
GROUP BY vendorName, subCategoryName
ORDER BY num_orders DESC
LIMIT 5

欲了解更多關於 GQL 語言支援的資訊，請參閱 GQL 語言指南。

相關內容

• GQL 語言指南
• GQL 精簡參考手冊
• 免費試用 Microsoft Fabric
• Microsoft Fabric 中的端對端教學課程