使用 LookML 图

LookML 示意图是一个使用 Looker 组件构建的 Web 应用,是使用 Looker 扩展程序框架开发的,并通过 Looker Marketplace 进行部署。

LookML 示意图是 LookML 模型的实体关系图,直观描述了其 LookML 对象之间的关系。使用此扩展程序可以:

  • 评估 LookML 模型的结构,确定可以整合 LookML 的领域并确定以最佳方式添加到模型
  • 识别不正确的逻辑,降低计算错误和查询性能不佳的可能性
  • 了解如何基于代码 (LookML) 进行数据建模

本文档页面介绍了如何使用 LookML 图表版本 2.0.0. 及更高版本。Looker 管理员应参阅配置 LookML 示意图扩展程序文档页面,了解如何为 Looker 用户启用此扩展程序。

本页面介绍了如何执行以下操作:

安装 LookML 图表后,您可以点击左侧导航面板中的代码块以选择 LookML 图表,然后选择 LookML 图表图块。

使用 LookML 图观察 LookML 对象关系

Looker 管理员必须向您授予 lookml_diagram 模型以及要在扩展程序中查看的任何模型的权限

LookML 示意图扩展包含以下元素:

  1. 图表设置面板,用于选择模型Git 分支探索
  2. 一个查看选项面板,供您查看要查看的字段
  3. 图表帮助部分,提供有关图表元素的更多说明
  4. 与所选“探索”中的 LookML 对象互动的示意图画布
  5. 所选探索的字段列表,按视图分组
  6. 包含缩放和位置选项的工具栏,以及用于显示或隐藏画布迷你地图图标的图标,有助于在较大的图中定位自己
  7. 一个对象分析器,用于查看 LookML 对象的相关信息,并导航到其关联的 LookML 或探索(如果适用)

双击图表设置图标或视图选项图标以收起左侧面板。

配置图表设置

点击图表导航栏中的图表图标即可显示图表设置

选择模型下拉列表会列出您具有权限的所有模型。选择模型后,系统会显示另外两个选项:

  • Current Branch(当前分支)下拉列表中会显示该模型的 Git 分支列表。如果模型只有一个分支(通常是生产分支),系统会显示该分支。如果您处于生产模式,或者您没有更改 Git 分支的权限,则系统会停用 Current Branch 下拉菜单。

    如果管理员已授权您在 LookML 示意图上更改 Git 分支,请开启开发模式,确保同时选择了模型和探索,然后选择一个分支,以根据在该分支上设置模型的方式查看图表。

  • 选择探索列表会填充该模型的“探索”列表。点击“探索”的名称可查看其在页面画布上显示的字段(按视图分组)。

探索查看选项

选择“探索”后,您可以使用视图选项面板限制画布上显示哪些字段和视图。

限制显示的字段

您可以选择在“探索”的每个视图中显示所有字段,方法是在要显示的字段下选择所有字段;或者,若要显示仅包含已联接其他字段的字段的视图,请选择包含联接的字段

启用后,隐藏隐藏字段切换开关会隐藏其底层 LookML 中包含 hidden: yes 的任何字段。隐藏隐藏字段切换开关默认处于启用状态。

限制显示的视图

“视图选项”面板的“视图”部分会显示选定“探索”中显示的视图列表。默认情况下,所有视图都显示在图表画布上。隐藏视图后,视图对象和将视图对象连接到“探索”中任何其他对象的任何联接都将在图表画布中隐藏。

点击全部隐藏,即可在图表画布中隐藏“探索”标签页中的所有视图。点击全部显示即可取消隐藏该“探索”中的所有视图。

您也可以通过取消选择视图名称右侧的眼睛图标,选择性地隐藏画布中的各个视图。隐藏视图后,视图名称会显示为灰色,而且眼睛图标中间有一条斜线。要取消隐藏单个的隐藏视图,请点击斜杠眼图标。

解读图表画布

在 LookML 示意图画布中,可以描绘指定探索的所有实体和关系。在 Looker 方言中,您可以将 LookML 图示为描述给定模型在“探索”中如何联接LookML 对象

画布顶部的对象标题栏会显示视图显示在画布上的“探索”部分的名称。点击对象标题栏中的“探索信息”图标(环绕着“i”),打开对象分析器,详细了解所选的“探索”。点击顺时针箭头以重新加载扩展程序。

实体

“探索”的每个视图均由其自己的实体集表示,其名称会显示在集顶部。

  1. “探索”的基本视图以深蓝色背景表示。
  2. “探索”功能的合并视图采用浅蓝色背景。
  3. 选择联接、视图或字段时,系统会以亮蓝色突出显示。

    每个视图下方都有属于该视图的字段列表:

  4. 维度列在顶部。

  5. 测量值列在底部,并以浅橙色突出显示。

  6. 如果该字段是主键,则字段名称右侧会显示一个键图标。

每个字段左侧都有一个图标,指示其类型:

  • A:尺寸为 type: string
  • #type: number 的维度或测量值
  • 分层栏:type: tier 尺寸
  • 对勾标记:type: yesno 的尺寸
  • 日历:type: datetype: date_timetype: time 的尺寸
  • 地图点:type: locationtype: distancetype: zipcode的尺寸

点击字段名称以打开对象分析器,并详细了解所选字段。

关系

此图使用了一条线来说明每个对象与所选模型中其他对象之间的关系。线的形状(附加到视图或字段)表示两个对象之间关系的基数;分支线表示“多个”基数,一条线表示“一个”基数。您可以将其解读为从基本视图到合并视图。例如:

  1. order_itemsinventory_items 的一对一联接,由 id 字段联接
  2. order_itemsrepeat_purchase_facts 的多对一联接

您还可以将鼠标悬停在该行上方,查看这两个对象的连接类型

点击相应行以打开对象分析器,以查看关于联接的更多信息。

画布查看选项

画布右上角的迷你地图可帮助您在较大的图表中更好地定位您的展示位置,其中灰显部分表示画布上当前显示的图表部分。点击并拖动画布中的空白区域,移至图表的其他部分。

画布左下角的纵向工具栏包含用于控制图表显示的图标:

  • 点击 (+) 可放大图表,点击 (-) 可缩小图表。
  • 点击方形图标即可返回图表的默认起始位置。
  • 点击地图图标即可启用或停用小地图。

使用对象性能分析器查看对象信息

对象分析器会显示有关所选对象的信息。点击图表画布上的任意“探索”、“视图”、“字段”或联接,即可打开画布右侧的对象性能分析器。点击画布以收起对象分析器。

探索

点击对象标题栏右侧的“探索信息”图标(环绕着“i”)。

对于在图表设置面板中选择的“探索”来说,对象分析器会显示:

  • 标签“探索”label 的值。
  • 组标签:group_label 参数的值,用于将“探索”合并到 Looker 的浏览菜单中的自定义组中。如果没有为“探索”定义组标签,则默认为模型名称。
  • 项目名称:LookML 项目的名称,如项目设置中所定义。
  • 连接名称connection 参数的值,用于指定模型将从中检索数据的数据库连接。

如果您拥有查看 LookML 的权限,可以点击对象分析器左下角的转到 LookML,打开定义“探索”的文件。系统会在新的浏览器标签页中打开文件,并突出显示 explore 对应的行。

查看次数

点击图表画布中的视图。

如果视图分析器的 LookML 中定义了 SQL 表名称,该对象分析工具将显示该名称。如果没有为视图定义 sql_table_nameSQL 表名称会显示为 unknown

如果您有权查看 LookML,则可以点击对象分析器左下角的 Go to LookML,打开定义视图所加入的探索的文件。系统会在新的浏览器标签页中打开文件,并突出显示 explore 对应的行。

字段

点击图表画布中的字段。

对象性能分析器会在面板顶部显示字段名称、类型和类型值,以及字段是否为主键。性能分析器中的两个标签页 DetailsCode 用于显示有关字段的更多信息。

详细信息标签页中,您可以查看:

  • 数据视图名称:字段所属的视图的名称。
  • 标签:在“探索”的“数据”部分中,该字段的显示方式。名称是视图的名称或标签,后跟字段的名称或标签
  • 分布:对于包含具有 type: count 的测量结果的视图,点击计算便可显示描述计数值分布的柱形图的预览。分布部分还会显示数值维度系列的最小值、最大值和平均值。
  • :对于包含 type: count 的测量结果的视图,点击计算即可显示计数值的预览。点击探索更多,打开此字段所属的“探索”。

在“代码”标签页中,您可以查看字段参数和子参数

如果您拥有查看 LookML 的权限,可以点击对象分析器左下角的转到 LookML,打开定义联接的文件。系统会在新浏览器标签页中打开联接所对应的“探索”所在的行,并打开该文件。

如果您拥有探索数据的权限,请点击对象分析器右下角的使用字段进行探索,打开“探索”字段选择器中预先选中的“探索”字段。

联接数

点击图表画布中的联接。

对象分析器会显示 join 语句,用于说明联接关系以及联接的类型基数

如果您拥有查看 LookML 的权限,可以点击对象分析器左下角的转到 LookML,打开定义联接的文件。系统会在新浏览器标签页中打开联接所对应的“探索”所在的行,并打开该文件。