生成 LookML 模型

本文档页面介绍了使用创建模型页面从数据库连接自动生成基本 LookML 模型的步骤。创建模型页面还可用于创建用于存放模型的项目。

您还可以通过其他方式创建模型文件：

  • 您可以通过 IDE 手动创建模型文件和其他项目文件。

  • 您可以使用旧版方法创建项目和生成模型，只需点击以下任一按钮即可前往旧版新建项目页面：

    进入新建项目页面后，按照创建新的 LookML 项目文档中的步骤操作。

访问创建模型页面

您可以通过以下方式访问创建模型页面：

如需访问创建模型页面，您必须处于开发模式。

若要访问创建模型页面，您必须是 Looker 管理员或拥有 develop 权限。

在开发部分

如需从开发部分访问创建模型页面，请完成以下步骤。

  1. 点击左侧导航面板中的开发。

  2. 从导航面板的开发部分中选择项目。

  3. 此选择会打开 LookML 项目页面。在 LookML 项目页面中，您可以查看自己有权访问的所有项目及其各自的模型。在 LookML 项目页面中，选择新建模型按钮以打开创建模型页面。

通过创建按钮

如需通过创建按钮访问创建模型页面，请完成以下步骤。

  1. 在主导航菜单中，点击创建按钮。
  2. 从下拉菜单中选择 LookML 模型。此时，系统会打开创建模型页面。

生成模型

创建模型页面分为多个部分。如需生成模型，请完成以下部分中的步骤。完成每个部分后，点击下一步以保存输入内容并进入下一部分。

  1. 选择数据库连接：

    • 选择数据库连接：从下拉菜单中选择数据库连接。您也可以从下拉菜单中选择创建新连接选项。这会将您转到将数据库连接到 Looker 页面，您可以在其中创建新连接。

    • 如果您有权访问已使用该关联的任何项目，则在选择该关联后，这些项目会显示出来。您可以选择将新模型添加到可用的现有项目，也可以选择为模型创建新的 LookML 项目。

    • LookML 项目名称：如果您想为模型创建新的 LookML 项目，请在此字段中输入项目名称。项目名称区分大小写，并且只能使用字母数字字符、_、. 和 -。请谨慎选择项目名称，并将其视为项目的永久 ID。新项目使用裸 Git 代码库进行配置。

    • 如果您希望 Looker 向新项目添加 README 文件，请选中生成详细介绍如何使用 LookML 的 Readme 文件复选框。README 文件包含 LookML 简介，以及有助于新手 LookML 开发者的链接和资源。

    • 点击下一步按钮保存条目，然后进入下一部分。

  2. 选择表：

    • 如果您使用的是 BigQuery 连接，请从选择 GCP 项目下拉菜单中选择 Google Cloud 数据集所在的项目，或在搜索项目名称字段中搜索项目。默认情况下， Google Cloud 存储空间项目（如果存在）会显示在下拉菜单中；如果不存在，则会显示 Google Cloud 结算项目。
    • 在表格中，选择要在模型中使用的“数据集”（BigQuery）或“架构”（其他方言）。
    • 选择数据集或架构后，使用每个数据集或架构名称右侧的箭头打开表标签页，然后选择要包含的每个表。系统将根据这些表创建视图。
    • 选择表后，使用每个表名称右侧的箭头打开字段标签页，然后选择要包含的每个字段。
    • 忽略前缀：如果您想忽略生成的视图文件名中的表前缀，请在此字段中输入以英文逗号分隔的数据库前缀列表。此字段区分大小写。您可以列出多个前缀，以英文逗号分隔。例如，您的表格名为 dwh_orders 和 DBS_users。如果您在忽略前缀字段中输入 dwh, DBS，则 Looker 会创建名为 orders 和 users 的视图文件。
    • 导入字段说明：选中此复选框可将数据库中的任何可用字段说明用作生成的维度的 LookML 说明。
    • 点击下一步按钮保存条目，然后进入下一部分。

  3. 选择主键：

    • 为您选择的每个表选择一个主键。这有助于 Looker 更好地将您的表进行联接。
    • 此步骤是可选步骤；如要跳过此步骤，请勿选择任何主键。
    • 点击下一步按钮保存条目，然后进入下一部分。

  4. 选择要创建的探索：

    • 选择要用作探索的基本视图的每个视图。对于每个选中的视图，系统都会自动联接尽可能多的其他视图。只有具有上一步中标识的主键的视图才能用于联接。
    • 此步骤是可选步骤；如要跳过此步骤，请勿选择任何视图。
    • 点击下一步按钮保存条目，然后进入下一部分。

  5. 输入模型名称：

  6. 点击以下按钮之一，即可生成模型文件和新项目（如果已选择）：

    • 完成并查看模型：Looker 会将您定向到 Looker IDE 中的文件。
    • 完成数据并进行探索：Looker 会将您定向到与选择要创建的探索部分中第一个所选视图文件对应的探索。

  7. 如果您创建了一个新项目，并希望将其关联到与 Looker 用于创建项目的裸 Git 代码库不同的代码库，请点击项目的项目设置页面的配置标签页上的重置 Git 连接按钮，以完成该过程。

何时需要配置模型

配置模型非常有用，原因如下：

  • 它用于指定给定模型名称是指特定项目中的特定模型。
  • 它会设置模型可以使用的连接。

管理员（或拥有 manage_models 或 manage_project_models 权限的开发者）在开发者模式下无需进行模型配置。这样，LookML 开发者就可以在开发模式下工作。不过，如果确实存在模型配置，则任何查询都受该配置的约束，即使在开发模式下也是如此。

虽然 LookML 开发者可以在模型文件中指定预期的连接，但管理员可以在 LookML 项目页面上控制允许的连接。如果模型指定使用在模型配置中不允许的连接，则不允许使用该连接。

在以下情况下，模型必须具有配置：

  • 首次将模型推送到生产环境时。如果未配置模型，则当模型处于生产模式时，对该模型的任何查询都会失败。首次将模型从开发模式推送到生产环境时，如果模型的名称在 Looker 实例中是唯一的，Looker 会自动配置该模型。不过，如果您在其他项目中有一个名称相同的已配置模型，Looker 不会自动配置该模型。
  • 在开发期间。如果您有开发者未获得 manage_models 权限（包含在 admin 角色中）或 manage_project_models 权限，则必须先配置模型，然后这些开发者才能对该模型运行查询。您可以在模型或项目存在之前配置模型。然后，当 LookML 开发者创建模型时，模型的允许连接已配置完毕，开发者可以成功运行查询。

借助 Looker，具有 manage_models 或 manage_project_models 权限的开发者可以在开发者模式下对未配置的模型运行查询。Looker 会通过在项目中搜索具有该名称的模型来实现此目的。系统会使用找到的第一个具有该名称的模型来运行查询。

配置预定模型

Looker 管理员可以使用 LookML 项目页面顶部的配置新模型按钮为现有模型或尚不存在的计划模型添加配置。

如果开发者未获得 manage_models 权限或 manage_project_models 权限，则提前配置模型会很有用。如果管理员为开发者配置了模型，那么开发者只需生成或创建模型文件，即可立即运行查询。

管理员还可以指定模型可以使用哪些数据库连接，或者可以指定允许模型使用任何当前或未来的连接。Looker 开发者使用 LookML connection 参数在模型文件中指定模型应使用的连接。如果开发者在模型的配置中指定了管理员未允许的关联，则系统不会运行对该模型的任何查询。

当管理员预先配置新模型并在该配置中创建新项目时，该项目会显示在项目页面的待处理项目部分中。

生成空白项目

如果您想从头开始创建 LookML 文件，创建空白项目会很有用。

创建模型页面会生成包含 LookML 文件的项目。不过，您可以只在创建模型页面中完成以下部分，从而最大限度地减少生成的 LookML 文件：

  • 选择数据库连接
  • 选择表
  • 输入模型名称

不填写其余部分。

点击 Complete and View Model（完成并查看模型）按钮，系统会将您转到 Looker IDE 中的项目。进入 IDE 后，您可以删除不需要的任何 LookML 文件，以创建一个空白项目。

后续步骤

创建模型或项目后，您可以执行以下操作：