创建新的 LookML 项目

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

一个 LookML 项目可以包含多个模型文件。但是，如果您想为用户指定查看和修改特定模型文件的 LookML 的权限，则可能需要创建新项目。虽然 Looker 中的大多数权限都在模型级别，但有一些权限适用于项目级别，包括 see_lookml（用于查看项目的 LookML）和 develop（可让您修改 LookML）。如果您想授权用户访问某个模型，但不想授予其他模型的访问权限，最好创建一个单独的项目，其中包含您不希望他们访问的模型。

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

创建项目

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

  1. 验证您是否处于开发模式。

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

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

此操作会打开 New Project 页面，您可以在其中指定项目的设置，包括项目的名称和起点。Looker 可以通过多种方式创建项目，具体步骤取决于您在 New Project 页面上选择的 Starting Point 选项。以下部分介绍了这些起点的工作原理：

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

如果您选择从数据库架构生成模型作为起点，LookML 生成器会根据数据库中的表自动创建模型并查看项目文件。如需了解详情，请参阅生成模型文档页面。

使用此选项时，Looker 会询问连接名称，以便它可以根据您的数据库自动生成 LookML。不过，您之后仍可添加其他关联。

克隆公共 Git 代码库

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

从公共 Git 代码库克隆的 Looker 项目是只读的。不过，您可以将只读项目导入另一个 Looker 项目，然后可以在其中修改文件。此外，您可以先从克隆的代码库文件入手，然后使用 Looker extends 参数或优化从此处构建项目。

如需将现有的公共 Git 代码库克隆到 Looker 项目中，请执行以下操作：

  1. 验证您是否处于开发模式。
  2. 从开发菜单中选择管理 LookML 项目 (Manage LookML Projects)。

  3. 在 LookML 项目页面中，选择新建 LookML 项目 (New LookML Project) 以打开新建项目页面。

  4. 在新建项目页面上，为项目指定选项：

    • 项目名称：为项目命名。请仔细选择项目名称，并将其视为项目的永久 ID，因为 Looker 通过以下方式使用项目名称：

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

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

    • 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。

  5. 选择创建项目。Looker 会将所有公共代码库的文件拉取到新的 LookML 项目中，并在 Looker IDE 中打开该项目。

创建空白项目

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

如需创建空白项目，请执行以下操作：

  1. 验证您是否处于开发模式。
  2. 从开发菜单中选择管理 LookML 项目 (Manage LookML Projects)。

  3. 在 LookML 项目页面中，选择新建 LookML 项目 (New LookML Project) 以打开新建项目页面。

  4. 在新建项目页面上，为项目指定选项：

    • 项目名称：为项目命名。请仔细选择项目名称，并将其视为项目的永久 ID，因为 Looker 通过以下方式使用项目名称：

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

    • 起点：选择 Blank Project。

  5. 选择创建项目。Looker 会创建项目，并在 Looker IDE 中打开它。

有了空白项目后，您可以创建model和查看文件，然后将项目连接到 Git，以便记录对 LookML 文件的更改并管理文件的版本。

配置模型

使用 LookML 项目页面顶部的配置新模型按钮，为现有模型或计划中的模型添加配置。

如果开发者尚未获得 manage_models 权限或 manage_project_models 权限（如生成模型文档页面中所述），为尚不存在的项目配置模型非常有用。如果您为开发者配置模型，则开发者在生成或创建模型文件后，就能立即运行查询。如需详细了解只含配置的项目，请参阅访问和修改项目信息文档页面。

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