生成模型

本页面提供了创建新项目以及根据您的数据库自动生成基本模型的步骤。

还有其他项目创建选项：您可以创建空白项目并手动创建其模型，也可以克隆现有的公共 Git 代码库，请参阅创建新的 LookML 项目文档页面。

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

  1. 点击菜单栏中的开发，并验证您是否处于开发模式。

  2. 从导航面板的 Develop 部分选择 Projects。

  3. 从 LookML 项目页面中，选择 New LookML 项目：

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

  4. 在 New Project 对话框中，指定项目的选项：

    • 为您的项目命名。
    • 对于起点，选择基于数据库架构生成模型。
    • 从连接下拉菜单中，选择数据库连接的名称。
    • 从 Build View From 中，选择一个选项：
      • 所有表：LookML 生成器会为数据库中的每个表创建一个视图文件。
      • 单个表：LookML 生成器为数据库中的一个表创建一个视图。如果您选择此选项，请输入数据库表的名称。
    • 要仅为数据库中的一个架构生成文件，请在架构文本字段中输入架构名称。您可以列出多个架构，用英文逗号分隔。
    • 如要在视图文件名之外使用表格前缀，请在 Ignore Prefixes 文本字段中输入数据库的前缀。此字段区分大小写。您可以列出多个前缀，并以英文逗号分隔。例如，您的表的标题分别为 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 文件的更改以及管理文件版本。

改进了 LookML 生成

如果您的 Looker 管理员启用了经过改进的 LookML Generation 实验室功能，在您基于数据库生成项目时，Looker 就会向您的项目添加其他元素：

  • Looker 将 README 文件添加到新项目中。README 文件包含 LookML 简介以及可帮助 LookLook 新开发者的链接和资源。
  • Looker 会为模型文件和每个视图文件添加几条内嵌注释说明。
  • 如果某个数据视图至少有一个维度中不包含名称字符串 id 的 type: number，那么 Looker 会创建一个 type: sum 指标和一个 type: average 指标，这两个指标都基于 type: number 的名称（不包含名称中的字符串 id）按字母顺序的第一个维度。

何时需要配置模型

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

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

管理员（或拥有 manage_models 权限的开发者）处于开发模式时，无需配置模型。这使 LookML 开发者可以在开发模式下轻松工作。但是，如果模型配置存在，则即使在开发模式下，任何查询也会受到该配置的限制。

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

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

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

有了 Looker，拥有 manage_models 权限的开发者可以在开发模式下对未配置的模型运行查询。Looker 通过在项目中搜索同名的模型来实现这一点。系统将使用第一个具有该名称的模型运行查询。