在 LookML 中对数据进行建模

了解如何使用 LookML 和 Looker IDE 以结构化且可重复使用的方式对数据进行建模。

在 Looker 中对数据进行建模的最简单方法是让 Looker 本身根据数据库中的表自动生成 LookML 文件。您可以通过根据示例数据生成模型快速入门练习此操作，并在生成 LookML 模型文档页面上查看完整过程。

本快速入门旨在向您展示如何手动将 LookML 文件添加到项目中，以及如何手动创建新的 LookML 元素，以便您根据自己的具体数据和需求自定义 LookML 项目。本快速入门将引导您手动创建 LookML 模型文件和 LookML 视图文件、为视图创建“探索”卡片、在视图文件中创建新维度，以及在“探索”界面中测试新测量。本快速入门还将引导您完成以下操作：开启开发模式、浏览 Looker IDE 以及使用 Looker IDE 快速帮助功能。本快速入门还将提供指向相关文档的链接，以便您详细了解这些主题。

首先，本快速入门使用在 Looker (Google Cloud Core) 实例上自动配置的 LookML 示例项目。

准备工作

如需跟随本快速入门操作，您需要满足以下条件：

开启开发者模式

Looker 项目可以采用以下两种模式之一：生产模式和开发模式。借助开发模式，您可以更改 LookML 文件并预览这些更改对实例中内容的影响，而不会影响生产环境（其他用户看到的内容）。如需了解详情，请参阅开发模式和生产模式文档页面。

在本快速入门中，您将使用开发模式，以便更改 LookML 文件并在“探索”中测试更改。

如需开启开发者模式，请按以下步骤操作：

  1. 在 Looker (Google Cloud Core) 首页上，点击 Looker 主菜单图标 以展开主导航菜单（如果尚未展开）。
  2. 选择菜单底部的开发模式切换开关。

启用开发模式后，Looker 会在屏幕顶部显示开发模式横幅。

LookML 项目是一个 LookML 文件集合，用于告知 Looker 如何连接到数据库、如何查询数据以及如何在界面中呈现数据。在本快速入门中，您将使用在 Looker (Google Cloud Core) 实例上自动配置的 LookML 示例项目。

如需在 Looker IDE 中打开 LookML 示例项目文件，请按以下步骤操作：

  1. 点击 Looker Main menu（主菜单）图标 ，然后选择 Develop（开发），前提是 Develop（开发）菜单尚未显示。
  2. 从 Develop 菜单中，选择 sample_thelook_ecommerce。

Looker 会打开 Looker IDE 的 File Browser 面板，并显示示例 LookML 项目文件。

创建一个新的项目文件夹

为使您在本快速入门中创建的文件与 LookML 示例项目中的其他文件分开，您需要为快速入门文件创建一个新的项目文件夹。

如需在项目中创建文件夹，请按以下步骤操作：

  1. 在 Looker IDE 的文件浏览器面板中，点击面板顶部的添加文件或文件夹 图标，然后从添加文件或文件夹菜单中选择创建文件夹选项。

  2. 输入 quickstart 作为新文件夹的名称。

  3. 点击创建。

Looker 会将新文件夹添加到 Looker IDE 中的文件浏览器面板。

有关 IDE 文件夹的其他信息

如需详细了解如何在 LookML 项目中使用文件夹，请参阅以下文档页面：

创建新的 LookML 模型文件

LookML 模型文件可指定数据库连接以及使用该连接的 Looker 探索集。在 LookML 中对数据进行建模后，用户可以通过探索在 Looker 中查询数据（请参阅在 Looker 中查看和与探索互动）。

如需在 LookML 项目中创建新的模型文件，请按以下步骤操作：

  1. 在 Looker IDE 的 File Browser 面板中，针对您在创建新的项目文件夹过程中创建的 quickstart 文件夹选择三点状 Folder Options 菜单。
  2. 从文件夹选项菜单中，选择创建模型。
  3. 在创建文件对话框中，为新文件输入名称 quickstart_practice，然后点击创建。 Looker 会在 quickstart 文件夹下创建 quickstart_practice.model 文件，并在 Looker IDE 中打开该新文件。文件浏览器面板中文件旁边的蓝点表示该文件是新文件。
  4. 在文件浏览器面板中，点击 quickstart 文件夹以将其展开，然后查看 quickstart_practice.model 文件。
  5. 在 Looker IDE 中，点击 quickstart_practice.model 文件以将其打开（如果尚未打开）。

quickstart_practice.model 文件包含示例 LookML，您可以将其用作项目的起点。目前，您可以将该文件保持原样。在本快速入门的后面部分，您将在模型文件中创建探索。

有关模型文件的其他信息

如需日后创建自己的模型文件，请记下以下资源：

创建新的 LookML 视图文件

在 LookML 中，视图对应于数据库中的单个表或单个派生表。视图文件用于指定要查询的数据库中的表，以及要从该数据库表中包含的字段（维度和测量）。在视图文件中定义字段后，您可以使用 $ 替换运算符在 LookML 的其他部分引用该字段。这样，您就可以在一个位置定义字段，同时在 LookML 项目的多个位置使用该字段。

您可以通过多种方式创建新的视图文件，但最简单的入门方式是让 Looker 本身根据数据库中现有表自动生成视图文件。

如需让 Looker 生成新的视图文件，请按以下步骤操作：

  1. 在 Looker IDE 的 File Browser 面板中，针对您在创建新的项目文件夹过程中创建的 quickstart 文件夹选择三点状 Folder Options 菜单。
  2. 从文件夹选项菜单中选择根据表格创建视图。

  3. 在根据表创建视图页面上，点击输入自定义数据库输入字段，然后输入 bigquery-public-data：

    “基于表创建视图”对话框。

  4. 按 Enter 键查看 BigQuery 公共数据集。

  5. 滚动列表，直到找到 thelook_ecommerce 数据集。

  6. 点击 thelook_ecommerce 数据集以将其展开。

  7. 选择 order_items 表。

  8. 点击页面底部的创建视图按钮。

Looker 会在 Looker IDE 中显示 order_items 视图文件。在“文件浏览器”面板中，quickstart 文件夹会展开，order_items 视图文件会显示一个蓝点，表示它是新文件。

有关视图文件的其他信息

如需日后创建自己的 View 文件，请记下以下资源：

Looker IDE 快捷帮助

现在，您已创建 LookML 模型文件和 LookML 视图文件。在本快速入门的后续步骤中，您将开始编辑这些文件。在开始编辑之前，您应熟悉 Looker IDE 快捷帮助功能。快捷帮助面板会针对 LookML 文件中当前光标位置提供说明和选项：

  • 在 IDE 编辑器面板中，您可以点击 LookML 文件中的字段和参数，快捷帮助面板将显示该 LookML 元素支持的选项和子参数。
  • 在快捷帮助面板中，您可以点击参数名称，以打开该参数的 Looker 文档页面。

如果快捷帮助面板尚未打开，您可以点击 Looker IDE 中的快捷帮助图标将其打开：

为您的视图创建探索

执行 Create a new LookML model file 过程和 Create a new LookML view file 过程后，您可以为新视图文件定义一个探索，以便使用 Looker 查询您在视图文件中建模的数据。

探索通常在模型文件中定义。（您可以创建单独的“探索”文件，但在本快速入门中，您将在模型文件中创建“探索”部分。）

在定义探索的 LookML 文件中，您必须使用 include 参数，以便在探索定义中引用视图文件。此过程将引导您完成这些步骤。

如需为 order_items 视图文件创建探索，请按以下步骤操作：

  1. 在 Looker IDE 中，打开 quickstart_practice.model 文件。

  2. 在 quickstart_practice.model 文件中，将包含 include 形参的现有行替换为以下行：

    include: "/quickstart/order_items.view"

  3. 在 include 参数下方添加新行，然后输入以下 LookML： 值，您可以从字段 none explore: order_items {} 中进行选择

  4. 点击 Looker IDE 顶部的 Save Changes（保存更改）按钮。

此探索是最基本的探索示例，允许用户查询 order_items 视图。从这个起点开始，您可以通过多种方式构建“探索”页面。

有关探索的其他信息

如需日后创建您自己的探索和完善探索，请记下以下资源：

新建字段

在本快速入门指南的创建新的 LookML 视图文件部分创建视图文件后，您可以看到 Looker 自动创建的字段。当您创建基于数据库表的视图文件时，Looker 会自动创建维度、维度组和测量：

  • 维度是表示属性、事实或值的字段，用户可以从“探索”中的字段选择器中选择该字段，并将其用于过滤查询。如果该字段不在 SUM、COUNT 等聚合函数内，则为维度。Looker 会自动为数据库表中的每个列创建一个维度。
  • 维度组用于一次性创建一组基于时间或时长的维度。例如，时间戳列的维度组将包含日期、月份、季度、时间、周和年份的各个维度。Looker 会自动为 Looker 在数据库表中检测到的基于时间的字段创建维度组。
  • 测量是探索中的字段，表示与数据相关的可衡量信息，例如总和、计数等。测量值是在视图文件中声明的，可以是汇总类型或非汇总类型。Looker 会自动为视图文件创建一个 type:count 衡量标准，该衡量标准相当于 SQL 中的 COUNT(*)。

在本部分中，您将学习如何手动将自己的维度添加到 order_items 视图文件。

如需在 order_items 视图文件中手动创建新维度，请按以下步骤操作：

  1. 如果 quickstarts/order_items.view 文件尚未打开，请打开该文件：在 Looker IDE 的 File Browser 面板中，点击 quickstart 文件夹以将其展开，然后点击 order_items.view 文件以将其打开。
  2. 在 quickstarts/order_items.view 文件中，在文件中第一个 dimension 参数前创建一个新行。

  3. 在新行中，开始输入 dimension。在您输入内容时，Looker IDE 会显示以您输入的文本开头的可能参数的列表。

    • 使用箭头键在建议列表中找到 dimension 选项。
    • 按 Enter 键将所选参数插入到 LookML 中。 Looker 会在您创建的新行中插入新的 dimension 参数。

  4. 如需为新维度提供名称，请在 IDE 中点击 {} 前面，然后输入 shipped_to_delivered_days。

  5. 点击 {} 内，然后按 Enter 键在 {} 内创建新行。

  6. 为新维度完成 LookML（您可以复制并粘贴以下 LookML，也可以手动输入 LookML，以查看 Looker IDE 如何提供指导）：

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. 点击 Looker IDE 顶部的 Save Changes（保存更改）按钮。

Looker 会使用新维度保存视图文件。对于文件中的新行，Looker IDE 会将行号着色为绿色。

有关 LookML 字段的其他信息

如需日后创建您自己的字段，请记下以下资源：

  • 如需了解 LookML 字段的一般信息，请参阅 LookML 字段参考文档页面。
  • 如需了解您可以在视图文件中创建的维度、过滤条件和参数类型，请参阅维度、过滤条件和参数类型文档页面。
  • 如需了解您可以在视图文件中创建的衡量类型，请参阅衡量类型文档页面。

在 Looker 界面中查看和测试更改

如果您执行了为视图创建探索过程，为 order_items 视图文件创建了探索，则可以在 Looker 探索界面中看到新维度。

如需在 Looker 界面的“探索”部分查看和测试所做更改，请按以下步骤操作：

  1. 在 Looker IDE 的 quickstarts/order_items.view 文件中，点击文件编辑器面板顶部视图文件名称旁边的查看文件操作箭头图标，然后选择 Explore Order Items - quickstart_practice 选项。

    “查看文件操作”菜单，其中已选择“探索有序项 - quickstart_practice”选项。

  2. 在订单项“探索”字段选择器中，点击其他日期组标签以将其展开，然后点击从发货到送达的天数维度将其添加到“探索”中。（您也可以在字段选择器搜索框中输入 Shipped to Delivered Days 来搜索该维度。）

  3. 在“订单项”探索字段选择器中，点击发货日期组标签以将其展开，然后点击日期维度将其添加到探索中。

  4. 在“Order Items”（订单项）探索字段选择器中，点击Delivered Date（送达日期）组标签以将其展开，然后点击 Date（日期）维度将其添加到探索中。

  5. 点击“探索”顶部的运行按钮。

Looker 将运行该查询，并在“探索”的数据部分中显示结果。对于每行，您可以验证订单商品发货至送达天数中的值是否显示了订单商品发货日期值和订单商品送达日期值之间的正确天数。

验证 LookML

在本快速入门中，您无需验证 LookML。不过，日后在您创建自己的项目来对数据进行建模时，了解用于验证 LookML 的 Looker 工具会很有帮助。

在您修改 LookML 时，Looker IDE 会提醒您单个文件中存在的任何未解析的语法错误（请参阅 Looker IDE 概览文档页面）。您还可以执行完整的模型验证，以检查 LookML 是否存在任何错误。如需了解详情，请参阅验证 LookML 文档页面。

提交更改

在本快速入门中，您将使用为示例 LookML 项目设置的预配置 Git 连接。不过，日后，当您创建自己的项目来对数据进行建模时，您需要为项目设置 Git 连接。

当您更改 LookML 项目文件时，Looker IDE 会在 IDE 右上角的 Git 按钮上显示不同的操作。该按钮会显示不同的操作，引导您完成验证 LookML 和将更改部署到生产环境的过程。

您在本快速入门中查看的 LookML 文件和“探索”功能仅在开发模式下可在个人 Git 分支中使用。如果您想将此模型提供给 Looker (Google Cloud Core) 实例中的其他用户，则需要提交更改、合并分支并部署生产分支。

在本快速入门中，您不会将更改部署到生产环境。而是按照清理过程所述删除这些文件。

清理

为最大限度提升 Looker 的性能，请勿将不必要的模型部署到生产环境。为保持个人 Git 分支的整洁，并避免意外将这些文件部署到生产环境，请完成以下步骤以删除您在本快速入门中创建的文件：

  1. 点击 Looker Main menu（主菜单）图标 ，然后选择 Develop（开发），前提是 Develop（开发）菜单尚未显示。
  2. 从 Develop 菜单中，选择 sample_thelook_ecommerce。
  3. 在 Looker IDE 的 File Browser 面板中，针对您在创建新的项目文件夹过程中创建的 quickstart 文件夹选择三点状 Folder Options 菜单。
  4. 从文件夹选项菜单中选择删除。
  5. 在删除文件夹窗口中，点击删除。

Looker 会删除 quickstart 文件夹及其所有内容。

后续步骤