创建新的 LookML 项目

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

LookML 项目可以包含多个模型文件。但是,如果您想为用户指定查看和修改特定模型文件的 LookML 的权限,则可能需要创建新项目。虽然 Looker 中的大多数权限适用于模型级,但也有一些权限适用于项目级,包括 see_lookml(可让您查看项目的 LookML)和 develop(可让您修改 LookML)。如果您想向用户授予对某个模型的访问权限,但不想授予对另一个模型的访问权限,不妨创建一个单独的项目,其中包含您不想让用户访问的模型。

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

创建项目

如需创建项目,请执行以下步骤:

  1. 确认您处于开发模式

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

  3. LookML 项目页面上,选择 New LookML Project(新建 LookML 项目),为您的项目选择选项。

此操作会打开 New Project 页面,您可以在其中指定项目的设置,包括项目的名称和起点。

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

自动从数据库生成模型

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

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

克隆公共 Git 代码库

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

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

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

  1. 确认您处于开发模式
  2. Develop 菜单中选择 Manage LookML Projects
  3. LookML 项目页面中,选择新建 LookML 项目 (New LookML Project) 以打开新建项目页面。

  4. New Project 页面上,为您的项目指定选项:

    • Project Name(项目名称):为您的项目命名。请仔细选择项目名称,并将其视为项目的永久 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 中打开该项目。

创建空白项目

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

如需创建空白项目,请执行以下操作:

  1. 验证您是否处于开发模式
  2. 开发菜单中选择管理 LookML 项目 (Manage LookML Projects)。
  3. LookML 项目页面中,选择新建 LookML 项目 (New LookML Project) 以打开新建项目页面。

  4. New Project 页面上,为您的项目指定选项:

    • Project Name(项目名称):为您的项目命名。请仔细选择项目名称,并将其视为项目的永久 ID,因为 Looker 通过以下方式使用项目名称:

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

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

创建空白项目后,您可以创建模型视图文件,然后将项目连接到 Git,以便记录对 LookML 文件的更改并管理文件的版本。

配置模型

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

如果开发者没有 manage_models 权限或 manage_project_models 权限(如生成模型文档页面中所述),为尚不存在的项目配置模型会很有用。如果您为开发者配置模型,那么他们在生成或创建模型文件后,便可立即运行查询。如需详细了解只含配置的项目,请参阅访问和修改项目信息文档页面。

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