创建新的 LookML 项目

项目是 LookML 文件的集合，用于描述数据库表之间的相互关系，以及 Looker 应如何解读这些表。如需详细了解项目，请参阅 LookML 项目和开发模型以及 LookML 术语和概念文档页面。如需了解如何访问和修改现有项目，请参阅访问和修改项目信息文档页面。

LookML 项目可以包含多个模型文件。不过，如果您想为用户指定查看和修改特定模型文件的 LookML 的权限，则可能需要创建一个新项目。虽然 Looker 中的大多数权限适用于模型级，但也有一些权限适用于项目级，包括 see_lookml（可让您查看项目的 LookML）和 develop（可让您修改 LookML）。

具有 manage_models 权限的 Looker 用户可以在 Looker 实例上创建 LookML 模型。

创建项目

如需创建项目，请执行以下步骤：

  1. 确认您处于开发模式。

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

  3. 在 LookML 项目页面上，选择新建 LookML 项目，为您的项目选择选项。

此操作会打开新建项目页面，您可以在其中为项目指定设置，包括项目名称和起始点。

Looker 可以通过多种方式创建项目，具体步骤取决于您在新建项目页面上选择的起始点选项。以下各部分介绍了这些起始点的运作方式：

自动从数据库生成模型

在新建项目页面上，指定以下选项以从数据库自动生成模型。

  1. Project Name（项目名称）：为您的项目命名。项目名称区分大小写，并且仅允许使用字母数字字符、_、. 和 -。请谨慎选择项目名称，并将其视为项目的永久 ID，因为 Looker 会以以下方式使用项目名称：

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

  2. 起点：选择根据数据库架构生成模型。

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

  4. 基于以下数据构建视图：选择以下选项之一：

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

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

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

最后，点击创建项目以创建包含生成的模型的项目。

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

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

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

克隆公共 Git 代码库

如果您选择克隆公共 Git 代码库作为起点，Looker 会将公共 Git 代码库中的文件复制到新的 LookML 项目中。

从公共 Git 代码库克隆的 Looker 项目是只读的。不过，您可以将只读项目导入到其他 Looker 项目中，然后在该项目中修改文件。此外，您还可以使用克隆的代码库文件作为起点，然后使用 Looker extends 参数或优化从中构建项目。

在新建项目页面中，指定以下选项以将现有的公共 Git 代码库克隆到 Looker 项目中：

  1. Project Name（项目名称）：为您的项目命名。项目名称区分大小写，不得使用空格或某些特殊字符。请谨慎选择项目名称，并将其视为项目的永久 ID，因为 Looker 会以以下方式使用项目名称：

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

  2. 起点：选择克隆公共 Git 代码库。

  3. Git 代码库网址：输入公共 Git 代码库的网址。请确保网址采用 git://github.com/example/my-repository.git 格式。

    如果您有网址（例如 https://github.com/llooker/blocks_redshift_admin），可以将其修改为正确的格式，方法是将“https://”替换为“git://”，然后在末尾添加“.git”。您输入的网址应为 git://github.com/llooker/blocks_redshift_admin.git。

最后，点击 Create Project。Looker 会将公共代码库的所有文件拉取到新的 LookML 项目中，并在 Looker IDE 中打开该项目。

创建空白项目

如果您选择 Blank Project（空白项目）作为起点，Looker 会创建一个空白项目，以便您从头开始创建 LookML 文件。

在 New Project 页面上，指定以下选项以创建一个空白项目：

  1. Project Name（项目名称）：为您的项目命名。项目名称区分大小写，不得使用空格或某些特殊字符。请谨慎选择项目名称，并将其视为项目的永久 ID，因为 Looker 会以以下方式使用项目名称：

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

  2. 起始点：选择空白项目。

最后，点击 Create Project。Looker 会创建项目并在 Looker IDE 中打开该项目。

后续步骤

创建项目后，您可以：