生成模型

本页介绍了创建新项目并从数据库自动生成基本模型的步骤。

您还可通过其他方式来创建项目文件：您可以创建空白项目并手动创建其模型；或者，如需克隆现有的公共 Git 代码库，请参阅创建新的 LookML 项目文档页面。

从您的数据库自动生成模型

您可以在 Looker 的开发部分或使用左侧导航面板中的创建按钮，从您的数据库自动生成模型。

在开发部分中生成模型

  1. 点击左侧导航面板中的 Develop，然后确认您处于开发模式。

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

  3. 在 LookML 项目页面中，选择新建 LookML 项目：

    • 在 LookML 项目页面中，您可以查看所有项目及其各自的模型。您可以使用此页面创建、查看和配置项目。

  4. 在新建项目对话框中，为项目指定选项：

    • Project Name（项目名称）：为您的项目命名。请谨慎选择项目名称，并将其视为项目的永久 ID，因为 Looker 会以以下方式使用项目名称：

      • 用于识别包含 project_id 参数的 API 调用的项目。
      • 用于在 Looker 实例的内部数据库中识别项目。
      • 为了确定用于本地项目导入的项目。
      • 如需在 LookML 项目页面上显示该项目。
      • 在 Looker 导航面板的开发部分显示该项目。
      • 是项目文件网址的一部分。例如，在网址为 example.looker.com 的 Looker 实例上，您可以在以下网址找到名为 ecommerce 的项目的项目清单文件：https://example.looker.com/projects/ecommerce/files/manifest.lkml。

    • 起点：选择从数据库架构生成模型。

    • 连接：从下拉菜单中选择数据库连接的名称。

    • Build View From：选择以下选项之一：

      • 所有表：LookML 生成器会为数据库中的每个表创建一个视图文件。
      • 单个表：LookML 生成器会为数据库中的一个表创建视图。如果您选择此选项，请输入数据库表的名称。

    • 架构：要仅为数据库中的一个架构生成文件，请在架构文本字段中输入架构的名称。您可以列出多个架构，以英文逗号分隔。

    • 忽略前缀：如要从视图文件名中排除表前缀，请在忽略前缀字段中输入数据库的前缀。此字段区分大小写。您可以列出多个前缀（用英文逗号分隔）。例如，您的表名为 dwh_orders 和 DBS_users。如果您在忽略前缀文本字段中输入 dwh, DBS，则 Looker 会创建名为 orders 和 users 的视图文件。

  5. 点击创建项目。

    • LookML 生成器会为项目创建一个模型文件，并为数据库中的每个表创建一个视图文件（除非另有指定）。然后，Looker 会在 Looker IDE 中打开新项目。
    • LookML 生成器为您的视图和模型文件创建 IDE 文件夹。如果您的数据库有多个架构，LookML 生成器会为架构创建一个文件夹。

对于 BigQuery 连接，如果您从数据库生成 LookML 项目，Looker 会使用 BigQuery 列元数据中的描述（如果有）自动填充字段说明。

生成器还会为每个数据库表创建一个“探索”。如需开始查询您的数据，请使用探索面板选择探索的名称。

如需在创建项目后对其进行重命名，请参阅访问和修改项目信息文档页面的重命名项目部分。

您可以按照了解模型和查看文件文档页面中的说明为项目手动创建其他模型，按照本页面的何时需要配置模型部分中的说明配置这些模型以在生产环境中使用，并在创建新的 LookML 项目文档页面中找到进一步的说明。

生成或手动创建模型文件后，请参阅设置和测试 Git 连接文档页面，了解如何将 Looker 项目连接到 Git。您可以记录对 LookML 文件所做的更改，以及管理文件的版本。

使用创建按钮生成模型

如需使用创建按钮创建项目并生成模型，请按以下步骤操作：

  1. 点击左侧导航面板中的创建按钮。
  2. 选择 LookML 模型菜单选项。
  3. 确认您处于开发模式。
  4. 进入开发模式后，系统会打开创建项目页面。
  5. 要为探索选择基本视图，或自定义其他高级选项（例如忽略生成的视图文件名中的表前缀、从数据库导入字段说明元数据、确定创建模型文件以及选择自动生成的自述文件），请启用高级项目创建选项。
  6. 从选择数据库连接下拉菜单中选择数据库连接。如果您有权访问已使用该关联的任何项目，则在选择该关联后，这些项目会显示出来。您可以选择使用现有项目并向其中添加新模型，也可以创建新的 LookML 项目。如果您选择将模型添加到项目中，创建模型页面首先会显示创建模型部分，您可以在该页面为模型命名。选择完毕后，点击下一步。
  7. 在选择数据部分，选择要用于模型的架构、表和字段。系统将根据表格创建视图。选择完毕后，点击下一步。
  8. 为每个表选择一个主键。这有助于 Looker 更好地将您的表联接在一起。完成选择后，点击下一步。
  9. 如果您启用了高级项目创建选项，请为探索选择基本视图。选择要用作探索的基本视图的每个视图。对于每个选中的视图，系统都会自动联接尽可能多的其他视图。只有具有上一步中标识的主键的视图才能用于联接。选择完毕后，点击下一步。
  10. 如果您启用了高级项目创建选项，请在高级选项部分中进行以下选择：
    • 忽略前缀 - 如要忽略生成的视图文件名中的表前缀，请在此字段中以英文逗号分隔的列表形式输入数据库前缀。此字段区分大小写。您可以列出多个前缀，以英文逗号分隔。例如，您的表名为 dwh_orders 和 DBS_users。如果您在忽略前缀文本字段中输入 dwh, DBS，则 Looker 会创建名为 orders 和 users 的视图文件。
    • 字段说明 - 选中导入字段说明元数据复选框，即可将数据库中的任何可用字段说明用作生成的维度的 LookML 说明。
    • 模型文件处理 - 选择是否创建模型文件。如果您选择创建模型文件，请在模型名称字段中输入要使用的文件名称。
    • 使用入门指南 - 选中生成描述如何使用输出的 Readme 文件复选框，以生成描述如何使用项目的 Readme 文件。
  11. 点击生成模型以生成项目文件。生成文件后，Looker 会将您转到 Looker IDE 中的相应文件。

改进了 LookML 生成功能

如果您的 Looker 管理员启用了改进的 LookML 生成实验室功能，那么当您通过数据库生成项目时，Looker 会向您的项目添加其他元素：

  • Looker 会将 README 文件添加到新项目中。README 文件包含 LookML 简介，并提供有助于新 LookML 开发者的链接和资源。
  • Looker 会向模型文件和每个视图文件添加多个内嵌注释说明。
  • 如果视图至少有一个维度 type: number 的名称中不包含字符串 id，则 Looker 会创建 type: sum 和 type: average 的度量，这两个维度均基于 type: number 的第一个维度，且名称中不包含字符串 id。

何时需要配置模型

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

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

管理员（或拥有 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 通过在项目中搜索具有该名称的模型来实现此目的。使用该名称找到的第一个模型将用于运行查询。