快速入门：在 Microsoft Fabric 中创建第一个图形

在本快速入门中，你将使用 Microsoft Fabric 中的图形创建包含两个节点和一个边缘的基本图形，然后运行查询。 此过程大约需要 15 分钟。

有关涵盖完整 Adventure Works 数据模型和更高级方案的综合性教程，请参阅 图形教程。

先决条件

在开始本快速入门之前，请验证：

1. 可以访问 Microsoft Fabric 容量（F2 或更高版本）或 Fabric 试用版。

2. Graph 在你的区域中可用。

3. Fabric 管理员在 Fabric 租户中启用了图表。 他们在 管理门户中启用此设置。

   

4. 你是 Fabric 工作区的成员，或者有权在工作区中创建项目。 有关详细信息，请参阅 Microsoft Fabric 中的 工作区。

   重要

   图形的访问管理仅限于托管图形的工作区。 工作区外部的用户无法访问图形。 有权访问 Lakehouse 中基础数据的工作区中的用户可以对图表进行建模和查询。

加载示例数据

若要创建图形，请先将示例数据加载到 Fabric 工作区中的 lakehouse 中。

下载示例数据

1. 转到 GitHub 上的 图形 GQL 示例数据集 。

2. 选择 adventureworks_docs_sample.zip 文件并将其下载到本地计算机。

   小窍门

   若要从GitHub下载文件，请选择该文件，然后选择 Download 原始文件图标。

3. 将下载 的adventureworks_docs_sample.zip 文件解压缩到本地计算机上的文件夹。

   小窍门

   在文件资源管理器中，右键单击 zip 文件，然后选择“ 全部提取”，然后选择目标文件夹。

创建湖屋

1. 在 Microsoft Fabric 中，选择工作区。

2. 选择 + 新建项目。

3. 选择 Store data>Lakehouse。

4. 输入名称（例如，“AdventureWorksLakehouse”），清除 Lakehouse 架构 选项，然后选择“ 创建”。

   重要

   Graph 当前不支持启用 lakehouse 架构的系统。

将数据加载到表中

对于本快速入门，只需两个表： adventureworks_customers 和 adventureworks_orders。 上传完整的示例数据文件夹，然后仅加载这两个表。

1. 在 Lakehouse 中，将鼠标悬停在 “文件”上，选择省略号（...），然后选择“ 上传>上传文件夹”。
2. 浏览到提取的文件夹并上传它。 此操作将所有示例数据文件上传到 Lakehouse。
3. 展开 “文件” 和“上传的文件夹”以查看子文件夹。 在本快速入门指南中，您只需将其中两个加载为表。
4. 将鼠标悬停在adventureworks_customers子文件夹上，选择省略号（...），然后选择“加载到表>”。
5. 将文件类型设置为 Parquet，然后选择“ 加载”。
6. 对 adventureworks_orders 子文件夹重复步骤 4-5。

创建图形模型

1. 在 Microsoft Fabric 工作区中，选择“+ 新建项。

2. 选择“分析和训练数据>图模型”（预览版）。

   

   小窍门

   或者，在搜索框中输入“graph”，然后按 Enter 搜索图形项。

3. 输入名称（例如“MyFirstGraph”），然后选择“ 创建”。

创建图形模型后，将进入图形视图，可在其中看到默认 模式设置为“ 模型”，其中顶部有 “保存”、“ 获取数据”、“ 添加节点”和 “添加边缘 ”按钮。

将数据添加到图形模型

若要将数据添加到图形模型，请在图形视图中执行以下步骤：

1. 选择“获取数据”。

2. 从 OneLake 目录中，选择包含 Adventure Works 数据的 Lakehouse。

3. 选择 并添加。

4. 选择 adventureworks_customers 和 adventureworks_orders 表，然后选择加载。

   

定义图形的结构

加载数据后，通过添加节点和边缘来定义图形的结构。 在本快速入门中，你将添加两种节点类型（Customer 和 Order）和一种边缘类型（purchases）来对客户与其订单之间的关系进行建模。

添加两个节点

1. 选择 “添加节点”。

2. 配置第一个节点：

   • 标签：Customer
   • 映射表：adventureworks_customers
   • 映射列的 ID：CustomerID_K

   

3. 选择“确认”。

4. 再次选择 “添加节点 ”。

5. 配置第二个节点：

   • 标签：Order
   • 映射表: adventureworks_orders
   • 映射列的 ID：SalesOrderDetailID_K

6. 选择“确认”。

添加一个边缘

1. 选择 “添加边缘”。

2. 配置边缘：

   • 标签：purchases
   • 映射表: adventureworks_orders
   • 源节点： Customer
   • 源映射列：CustomerID_FK
   • 目标节点： Order
   • 目标映射列：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 中的图形？ - 了解图形概念。