LookML Diagram 是一个扩展程序，这是一个使用 Looker 组件构建的 Web 应用，使用 Looker 扩展框架开发并通过 Looker Marketplace 部署。
LookML 图表是 LookML 模型的实体关系图，可直观地描述其 LookML 对象之间的关系。此扩展程序可用于：
- 评估 LookML 模型的结构，确定可以整合 LookML 的区域，并确定如何以最佳方式添加到模型中
- 识别不正确的逻辑，从而减少计算不正确和查询性能不佳的可能性
- 了解如何进行基于代码 (LookML) 的数据建模
本文档页面介绍了如何使用 LookML Diagram 2.0.0. 及更高版本。Looker 管理员应参阅配置 LookML 图表扩展程序文档页面，了解如何为 Looker 用户启用此扩展程序。
本页将介绍如何执行以下操作：
导航到 LookML 图
安装 LookML 图表后，您可以点击左侧导航面板中的 Blocks，然后选择 LookML 图表图块，导航到 LookML 图表。
使用 LookML 图观察 LookML 对象关系
您的 Looker 管理员必须向您授予 lookml_diagram 模型以及您要在扩展程序中查看的任何模型的权限。
LookML Diagram 扩展程序包含以下元素：
- Diagram Settings 面板，用于选择model、Git 分支和探索
- “View Options”面板，用于优化要查看的字段
- 图表帮助部分，用于提供图表元素的其他说明
- 与所选探索中的 LookML 对象交互的图表画布
- 所选探索的字段列表，按视图分组
- 一个工具栏，包含缩放和位置选项，还有一个用于显示或隐藏画布迷你地图的图标，这有助于您在较大的图表中定位自己
- 对象性能分析器，用于查看有关 LookML 对象的信息，并导航到与其关联的 LookML 或探索（如果适用）
双击 Diagram Settings 图标或 View Options 图标以收起左侧面板。
配置图表设置
点击图表导航栏中的图表图标，以显示图表设置。
选择模型下拉列表中列出了您有权查看的所有模型。选择模型后，系统会显示两个额外的选项：
当前分支下拉列表中填充该模型的 Git 分支列表。如果模型只有一个分支（通常是生产分支），系统会显示该分支。如果您处于生产模式，或者没有更改 Git 分支的权限，则会停用当前分支下拉菜单。
如果您的管理员已向您授予在 LookML Diagram 上更改 Git 分支的权限，请启用开发模式，确保同时选择模型和探索，然后选择一个分支，以便根据模型在该分支上的设置方式查看图表。
选择探索列表会填充该模型的探索列表。点击探索的名称，以查看按视图分组并显示在页面画布上的字段。
探索观看选项
选择“探索”后，您可以使用“视图选项”面板限制在画布上显示的字段和视图。
限制显示的字段
您可以选择要显示的字段下的所有字段，选择显示“探索”的每个视图中的所有字段；或者，要仅显示包含与其他字段联接的字段的视图，请选择具有联接的字段。
启用后，隐藏隐藏字段切换开关会隐藏其底层 LookML 中包含 hidden: yes 的任何字段。隐藏隐藏字段切换开关默认处于启用状态。
限制显示的视图
“视图选项”面板的“视图”部分会显示所选探索中显示的视图列表。默认情况下，所有视图都显示在图表画布上。隐藏视图后，视图对象以及将该视图对象与“探索”中任何其他对象连接的任何联接都将在图表画布中隐藏。
点击全部隐藏可在图表画布中隐藏“探索”中的所有视图。点击全部显示可取消隐藏该探索中的所有视图。
您还可以选择隐藏画布中的个别视图，只需取消选中视图名称右侧的眼睛图标即可。视图隐藏时，视图名称会灰显，并且眼睛图标中间有一条斜线。要取消隐藏单个隐藏视图，请点击斜线图标。
解读图表画布
LookML 图表画布描述了给定探索的所有实体和关系。在 Looker 方言中，您可以将 LookML 图表视为描述如何将 LookML 对象联接到给定模型的“探索”中。
画布顶部的对象标题栏显示了在画布上显示其视图的探索的名称。点击对象标题栏中的“探索”信息图标（一个带圆圈的“i”），可打开对象分析器并详细了解所选探索。点击顺时针箭头，以重新加载该扩展程序。
实体
探索的每个视图都表示为自己的实体集，视图名称显示在该集的顶部：
- “探索”的基本视图采用深蓝色背景。
- “探索”中联接的视图具有浅蓝色背景。
联接、视图或字段被选中后，会以亮蓝色突出显示。
每个视图下方是属于该视图的字段列表：
维度列在顶部。
测量值在底部列出，并以浅橙色突出显示。
如果字段是主键，则字段名称的右侧会显示一个键图标。
每个字段左侧都有一个表示其类型的图标：
- A：
type: string的尺寸 - #：
type: number的维度或测量 - 分级条形：尺寸为
type: tier - 对勾标记：
type: yesno的尺寸 - 日历：尺寸：
type: date、type: date_time、type: time - 地图上的点：尺寸为
type: location、type: distance、type: zipcode
点击字段名称以打开对象性能分析器，详细了解所选字段。
关系
此图通过一条线来描绘所选模型中每个对象与其他对象之间的关系。附加到视图或字段的线的形状传达了两个对象之间关系的基数；分支线表示“多个”基数，单个线表示“1”基数。您应将这种关系解读为“从基本视图到联接视图”。例如：
- 从
order_items到inventory_items的一对一联接，在id字段中联接 - 从
order_items到repeat_purchase_facts的多对一联接
您也可以将鼠标悬停在该行上，查看两个对象之间的联接类型关系。
点击相应行以打开对象性能分析器，查看有关联接的详细信息。
画布查看选项
画布右上角的小地图有助于定位您在较大图表中的位置，其中灰显的地图部分会指示画布上当前显示的图表部分。点击并拖动画布中的空白区域，即可移至图表的其他部分。
画布左下角的垂直工具栏包含用于控制图表显示的图标：
- 点击 (+) 可放大，点击 (-) 可缩小图表。
- 点击方形图标即可返回图表的默认起始位置。
- 点击地图图标可启用或停用迷你地图。
使用对象性能分析器查看对象信息
对象性能分析器会显示所选对象的相关信息。点击图表画布上的任意探索、视图、字段或联接，即可打开画布右侧的对象性能分析器。点击画布即可收起对象性能分析器。
探索
点击对象标题栏右侧的“探索”信息图标（一个带圆圈的“i”）。
对于在图表设置面板中选择的“探索”，对象性能分析器会显示：
- 标签：探索
label的值。 - 群组标签：
group_label参数的值，用于将探索合并到 Looker 的探索菜单中的自定义群组。如果没有为探索定义组标签，则默认为模型的名称。 - Project Name：LookML 项目的名称，如项目设置中所定义。
- 连接名称：
connection参数的值，用于指定模型将从中检索数据的数据库连接。
如果您有权查看 LookML，则可以点击对象性能分析器左下角的 Go to LookML，以打开定义探索的文件。系统会在新的浏览器标签页中打开该文件，并突出显示 explore 行。
视图
点击图表画布中的视图。
对象性能分析器会显示 SQL 表名称（如果已在视图的 LookML 中定义）。如果没有为视图定义 sql_table_name，SQL 表名称会显示为 unknown。
如果您有权查看 LookML，则可以点击对象性能分析器左下角的前往 LookML，以打开定义视图联接的“探索”的文件。系统会在新的浏览器标签页中打开该文件，并突出显示 explore 行。
字段
点击图表画布中的字段。
对象性能分析器在面板顶部显示字段名称、类型和类型值，以及该字段是否为主键。性能分析器中的两个标签页（Details 和 Code）会显示有关该字段的更多信息。
在详细信息标签页中，您可以查看：
- 视图名称：字段所属视图的名称。
- 标签：字段在探索的“数据”部分中的显示方式，包括数据视图的名称或标签，后跟字段的名称或标签。
- 分布：对于测量值为
type: count的视图的数字维度，点击 Calculate 以显示描述计数值分布的柱形图预览。分布部分还会显示数字维度系列的最小值、最大值和平均值。 - 值：对于具有
type: count的测量的视图上的数字维度，请点击 Calculate 以显示计数值的预览。点击探索更多可打开此字段所属的“探索”。
在“代码”标签页中，您可以查看字段参数和子参数。
如果您有权查看 LookML，则可以点击对象性能分析器左下角的 Go to LookML，以打开定义联接的文件。系统会在新的浏览器标签页中打开文件，并将其放在联接的“探索”对应的行。
如果您有权探索数据，请点击对象性能分析器右下角的使用字段探索，以打开已在“探索”字段选择器中预选该字段的“探索”。
联接数
点击图表画布中的联接。
对象性能分析器会显示 join 语句，说明联接关系以及联接的类型和基数。
如果您有权查看 LookML，则可以点击对象性能分析器左下角的 Go to LookML，以打开定义联接的文件。系统会在新的浏览器标签页中打开文件，并将其放在联接的“探索”对应的行。