使用可视化建模画布

预览版： 此功能受服务专用条款的“通用服务条款”部分中的“正式发布前产品条款”的约束。正式发布前产品和功能按“原样”提供，可能支持有限。如需了解详情，请参阅发布阶段说明。

如果您在视觉建模画布的公开预览期间遇到问题或有反馈，请发送电子邮件至 [e-mail] 进行报告。

借助 Looker 中的视觉建模画布，您可以连接到 BigQuery 数据源，以便使用交互式拖放画布构建和修改 LookML 数据模型。借助视觉建模画布，您可以直观地联接表、定义维度和度量、实时预览查询结果，以及发布探索，而无需编写 LookML 代码。

画布组件

视觉建模画布包含以下工作区组件和导航标签页：

• 来源 数据库：一个可搜索的边栏，用于显示有效连接上的可用数据库数据集、表和视图
• 视觉画布 graph_4：主工作区，您可以在其中拖动表、排列表节点和定义联接关系
• LookML 代码 code：一个面板，用于显示视觉模型背后的生成的 LookML 代码
• 数据预览 table_chart：一个可折叠的底部面板，用于显示联接数据集的实时查询预览 (LIMIT 100)
• 字段编辑器 edit_attributes：一个用于添加、重命名和自定义维度和度量的面板

准备工作

如需使用视觉建模画布，您必须具备以下条件：

• 运行 Looker 26.14 或更高版本的 Looker 实例，该实例由 Looker 管理员配置为启用自助探索
• 已配置以下设置的 BigQuery 数据库连接：
  • 在连接页面的数据库标签页中配置了所有项目范围
  • 已配置为使用 OAuth 进行 身份验证
• 具有 create_self_service_from_table 权限的 Looker 用户账号
• 具有目标 BigQuery 表的以下 IAM 角色的 Google 账号：
  • bigquery.jobUser
  • bigquery.dataViewer

创建视觉模型

以下部分介绍了使用视觉建模画布创建新数据模型的步骤：

1. 连接到您的数据库
2. 将表添加到画布
3. 定义关系和联接
4. 添加和配置度量和维度
5. 实时预览数据
6. 查看模型的 LookML
7. 将模型发布到探索

连接到您的数据库

如需连接到您的数据库，请按以下步骤操作：

1. 在 Looker 中，点击主导航栏中的创建 按钮。
2. 选择数据源 。
3. 在创建数据源 对话框中，选择连接到数据库 标签页。
4. 从 BigQuery 连接 下拉菜单中选择数据库连接。
5. 指定您的项目：
   • 选择从列表中选择 ，以从连接上的可用项目中进行选择。
   • 选择手动输入 ，以直接输入项目 ID。
6. 指定是包含所有表还是选择特定表：
   • 选择包含此选定项目中的所有数据集和表格 ，以从空白画布开始。在空白画布中，您可以从来源列表中添加表。
   • 选择选择特定表格 ，以指定要添加到画布的单个数据集和表。视觉建模画布将打开字段编辑器，并从您选择的表中加载字段。您可以点击导航栏中的视觉画布 graph_4，在画布中查看表。您可以从来源列表中添加其他表。
7. 点击继续 以打开视觉建模画布。

将表添加到画布

如需将表添加到画布以开始对数据进行建模，请按以下步骤操作：

1. 在来源 数据库 边栏中，浏览或搜索要建模的数据集、表或视图。
2. 将每个表从边栏拖到画布上。
3. 在画布上重新定位表节点，以整理数据模型布局。

将表拖到画布上时，视觉建模画布会将其表示为表节点 。画布会显示表名称及其 BigQuery 项目和数据集 ID。添加到画布的第一个表会被标记为基本视图 。

定义关系和联接

当您向画布添加多个表时，视觉建模画布会扫描匹配的列名称（例如 orders 和 order_items 中的 order_id），并自动在表之间建议联接连接线。

如需修改或创建数据库中表之间的关系，请按以下步骤操作：

1. 点击两个表节点之间的联接连接线，打开联接配置 面板。在联接配置 面板中配置联接：
   • 联接类型：选择联接类型（左外、内或全外）。默认情况下，Looker 使用左外联接。
   • 关系（基数）：选择关系类型（一对一、一对多、多对一或多对多）。
   • 联接子句：查看自动建议的联接键，或添加自定义联接条件。您可以指定多个联接条件（例如 orders.id = order_items.order_id AND orders.date = order_items.date）。
2. 解决联接错误：如果联接创建了无效的 SQL 路径或循环引用，连接线会变为红色，并显示说明性工具提示。调整联接键或关系基数以解决错误。
3. 如果您更改了联接设置，请点击应用 以将更改应用于联接。

添加和配置度量和维度

视觉建模画布会自动为您的表设置维度和度量，并允许您添加自定义计算。默认情况下，视觉建模画布会为数字字段创建 count 或 sum 类型的度量，同时将名称包含 ID、Key 或 Code 的字段保留为数字维度。当您定义一对多 关系时，视觉建模画布会自动应用对称聚合逻辑，以防止扇出和重复值计算错误。

您无法删除生成的字段；您只能隐藏它，方法是在字段编辑器的字段齿轮菜单中选择隐藏 ，或者点击字段的修改 edit 图标，然后选中在探索和可视化图表中隐藏此字段 复选框。

如需查看表的字段，请在画布中选择表节点，然后点击修改字段 。

在字段编辑器中，您可以执行以下任务：

• 修改维度
• 修改度量
• 创建自定义维度
• 创建自定义度量

修改维度

如需修改现有维度，请按以下步骤操作：

1. 在视觉建模画布中，选择画布中的表节点，然后点击修改字段 以打开字段编辑器。
2. 在字段编辑器中，点击维度 标签页。
3. 找到要修改的维度，然后点击字段的修改 图标 edit，打开修改维度 对话框。
4. 更新以下任一字段（数据类型 字段为只读字段）：
   • 格式：从下拉菜单中选择格式设置选项。
   • 名称：修改用于在 LookML 和表达式中标识维度的名称。
   • 标签：修改在探索和可视化图表中显示的标签。
   • + 添加说明：点击此选项可输入或修改维度的可选说明。
   • 在探索和可视化图表中隐藏此字段：选中或取消选中此复选框可隐藏或显示维度。
5. 点击保存 。

修改度量

如需修改现有度量，请按以下步骤操作：

1. 在视觉建模画布中，选择画布中的表节点，然后点击修改字段 以打开字段编辑器。
2. 在字段编辑器中，点击度量 标签页。
3. 找到要修改的度量，然后点击字段的修改 图标，打开修改度量 对话框。

4. 更新以下任一字段：

   注意： 对于计数度量，您只能修改标签、格式、说明和在探索和可视化图表中隐藏此字段。
   • 要测量的字段：从下拉菜单中选择要聚合的字段。
   • 度量类型：从下拉菜单中选择聚合类型（例如求和、计数、平均值、最小值或最大值）。
   • 标签：修改在探索和可视化图表中显示的标签。
   • 过滤条件标签页：在缩小结果范围下，从过滤条件名称下拉菜单中选择一个字段，然后指定过滤条件值。使用 + 和 - 按钮添加或移除过滤条件。
   • 字段详细信息标签页：从格式下拉菜单中选择格式设置选项，然后输入可选说明（最多 255 个字符）。
   • 在探索和可视化图表中隐藏此字段：选中或取消选中此复选框可隐藏或显示度量。

5. 点击保存 。

创建自定义维度

如需使用 Looker 表达式创建自定义维度，请按以下步骤操作：

1. 在视觉建模画布中，选择画布中的表节点，然后点击修改字段 以打开字段编辑器。
2. 在视觉建模画布的字段编辑器中，点击添加维度 以打开创建维度 对话框。
3. 在表达式编辑器框中，输入定义维度的 Looker 表达式，或点击 使用 Gemini 帮我编写表达式 以生成表达式。
4. 从格式 下拉菜单中选择格式设置选项。
5. 输入维度的名称 和标签 。
6. （可选）点击 + 添加说明 以输入或修改维度的说明。
7. （可选）选中在探索和可视化图表中隐藏此字段 复选框以隐藏维度。
8. 点击保存 。

创建自定义度量

如需创建自定义度量，请按以下步骤操作：

1. 在视觉建模画布中，选择画布中的表节点，然后点击修改字段 以打开字段编辑器。
2. 在字段编辑器中，点击度量 标签页，然后点击添加度量 以打开创建度量 对话框。
3. 从要测量的字段 下拉菜单中选择要聚合的字段。
4. 在度量类型 下拉菜单中，选择要对要测量的字段 字段执行的聚合类型。
5. 输入度量的标签 。
6. 配置可选的过滤条件或格式设置详细信息：
   • 过滤条件标签页：在缩小结果范围下，从过滤条件名称下拉菜单中选择一个字段，然后指定过滤条件值。使用 + 和 - 按钮添加或移除过滤条件。
   • 字段详细信息标签页：从格式下拉菜单中选择格式设置选项，然后输入可选说明（最多 255 个字符）。
7. （可选）选中在探索和可视化图表中隐藏此字段 复选框以隐藏度量。
8. 点击保存 。

实时预览数据

请按照以下步骤验证模型的数据输出：

1. 在视觉建模画布中，点击导航栏中的数据预览 标签页 table_chart。
2. 点击画布中的表，以从该表中选择字段。
3. 在数据预览窗格中，点击预览列 下拉菜单。

4. 从下拉菜单中，选择要查询的表中的字段，然后点击预览 。

   视觉建模画布将查询您的数据库，并在数据预览窗格中的表中显示查询结果。

5. 检查数据，确保不会发生意外的行扇出或记录丢失。

6. 根据需要更新联接或字段，然后点击数据预览窗格中的刷新架构 以更新表。

查看 LookML

点击 LookML 代码 标签页 code，检查为模型生成的 LookML。视觉模型的 LookML 是只读的。如果您要修改字段和联接，请使用视觉建模画布。

将模型发布到探索

如需保存模型，请点击视觉建模画布中的探索数据 按钮。

Looker 会生成底层 LookML 模型文件并保存画布布局坐标。您的模型现已发布，可以进行查询。

访问视觉模型

已发布的视觉模型会显示在 Looker 导航栏的探索 下的自助探索 部分中。

如需查询视觉模型，请按以下步骤操作：

1. 在 Looker 中，点击主导航栏中的探索 。
2. 在自助探索下，选择模型的探索名称。
3. 从字段选择器中选择维度和度量，添加过滤条件，然后运行查询以创建可视化图表和信息中心板块。

修改现有视觉模型

如需修改使用视觉建模画布创建的现有模型，请按以下步骤操作：

1. 在 Looker 中，点击主导航菜单中的探索 。
2. 在自助探索下，打开要修改的模型的探索。
3. 从探索的字段选择器中选择修改模型 ，以打开视觉建模画布。如果您使用的是传统探索体验，请从探索的齿轮菜单中选择修改模型 。
4. 在视觉建模画布中进行更改（例如添加表、更新联接子句或创建新的度量）。
5. 点击探索数据 以更新模型。

注意： 如果多个用户修改同一视觉模型，系统会保留最近保存的版本。

删除视觉模型

如需删除视觉模型，请按以下步骤操作：

1. 在 Looker 中，点击主导航菜单中的探索 。
2. 在自助探索下，打开要修改的模型的探索。
3. 从探索的字段选择器中选择修改模型 ，以打开视觉建模画布。如果您使用的是传统探索体验，请从探索的齿轮菜单中选择修改模型 。
4. 在视觉建模画布中，从三点状菜单中选择删除 。