快速入門：在 Microsoft Fabric 建立你的第一個圖表

備註

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

在這個快速入門中，你會使用 Microsoft Fabric 中的圖形建立一個包含兩個節點和一條邊的基本圖形，然後執行查詢。 這個過程大約需要15分鐘。

若想獲得涵蓋完整 Adventure Works 資料模型及更進階情境的完整教學，請參閱 圖形教學。

先決條件

在開始這個快速入門之前，請先確認：

1. 在你這個地區可使用 Graph。

2. Graph 已啟用於你的 Fabric 租戶中。 Fabric 管理員會在 管理入口網站啟用此設定。

   

3. 你是 Fabric 工作區的成員，或有權限在工作區中建立項目。 欲了解更多資訊，請參閱Microsoft Fabric 中的工作區。

   這很重要

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

載入範例數據

要建立你的圖表，首先將樣本資料載入到你的 Fabric 工作區中的資料湖屋（lakehouse）。

下載範例資料

1. 請前往 GitHub 上的 圖表 GQL 範例資料集。

2. 選擇 adventureworks_docs_sample.zip 檔案並下載到你的本地機器。

   小提示

   要從GitHub下載檔案，請選擇該檔案，然後選擇Download 原始檔案圖示。

3. 把下載的 adventureworks_docs_sample.zip 檔案解壓到你本機的資料夾。

   小提示

   在檔案總管中，右鍵點擊壓縮檔並選擇 「全部解壓」，然後選擇目標資料夾。

建立湖倉

1. 在 Microsoft Fabric 中，選擇你的工作區。

2. 選取 + 新增項目。

3. 選擇 儲存資料>Lakehouse。

4. 輸入名稱（例如「AdventureWorksLakehouse」），清除 Lakehouse 架構選項 ，然後選擇 建立。

   這很重要

   Graph 目前不支援 啟用 Lakehouse 架構（預覽）的 Lakehouses。

將資料載入表格

這個快速入門只需要兩張表格： adventureworks_customers 和 adventureworks_orders。 上傳完整的範例資料資料夾，然後只載入這兩個資料表。

1. 在你的湖邊小屋裡，將滑鼠移到 檔案上，選擇省略號（...），然後選擇 「上傳>上傳」資料夾。
2. 瀏覽解壓後的資料夾並上傳。 這個動作會把所有範例資料檔案上傳到你的湖屋。
3. 展開 檔案 和已上傳的資料夾，可以看到子資料夾。 這個快速入門只需要載入其中兩個表格。
4. 將滑鼠移到 adventureworks_customers 子資料夾上，選擇省略號（...），然後選擇 載入到資料表>新資料表。
5. 將檔案類型設為 Parquet，並選擇 載入。
6. 重複第 4 到 5 步，針對 adventureworks_orders 子資料夾。

建立圖形模型

1. 在你的 Microsoft Fabric workspace 中，選擇 + 新項目。

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

   

   小提示

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

3. 輸入名稱（例如「MyFirstGraph」）並選擇 「建立」。

建立好圖模型後，你會進入圖視圖，看到預設模式設為 「Model 」，頂部有「 儲存」、「 取得資料」、「 新增節點」和「 Add 邊 」按鈕。

建立圖表

要在 Microsoft Fabric 中建立圖表，請在圖形檢視中依照以下步驟操作：

1. 選取 [取得資料。

2. 從 OneLake 目錄中，選擇 Adventure Works 資料中的湖屋。

3. 選擇 連線。

4. 選擇 adventureworks_customers 和 adventureworks_orders 資料表，然後選擇 載入。

   

新增兩個節點

1. 選擇 新增節點。

2. 配置第一個節點：

   • 標籤：客戶
   • 映射表：adventureworks_customers
   • 地圖欄位識別碼：CustomerID_K

   

3. 選取確認。

4. 再次選擇 新增節點 。

5. 設定第二個節點：

   • 標籤：訂單
   • 地圖表：adventureworks_orders
   • 映射欄識別碼：SalesOrderDetailID_K

6. 選取確認。

新增一條邊

1. 選擇 新增邊緣。

2. 設定邊緣：

   • 標籤：購買
   • 地圖表：adventureworks_orders
   • 來源節點：客戶
   • 資料來源繪製欄：CustomerID_FK
   • 目標節點：訂單
   • 目標地圖欄：SalesOrderDetailID_K

   

3. 選取確認。

4. 選擇 儲存 以載入圖表。

查詢你的圖表

執行 GQL 查詢，找出訂單數量排名前五的客戶。

1. 選擇 查詢 模式。

2. 從頂端選單選擇 程式碼編輯器 。

3. 請在輸入框中輸入以下 GQL 查詢：

   MATCH (c:Customer)-[:purchases]->(o:`Order`)
   RETURN c.fullName AS customer_name, count(o) AS num_orders
   GROUP BY customer_name
   ORDER BY num_orders DESC
   LIMIT 5
   

4. 選擇 「執行查詢 」以查看訂單數量排名前五的客戶。

下圖展示了 GQL 查詢及其結果：

祝賀！ 你在 Microsoft Fabric 建立第一個圖表，並對它執行查詢。

後續步驟

• 圖教學 - 建立包含多個節點、邊與查詢的完整圖
• GQL 語言指南 - 學習 GQL 語法
• Microsoft Fabric 中的圖形是什麼？ - 學習圖概念