创建新的 LookML 项目

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

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

创建项目

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

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

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

  3. 在 LookML 项目页面上，选择 New LookML Project 以选择项目的选项。

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

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

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

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

克隆公共 Git 代码库

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

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

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

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

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

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

    • 项目名称：为您的项目命名。
    • 起点：选择克隆公共 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. 选择 Create Project。Looker 会将所有公开代码库的文件拉取到新的 LookML 项目中，并在 Looker IDE 中打开该项目。

创建空白项目

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

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

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

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

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

    • 项目名称：为您的项目命名。
    • 起点：选择 Blank Project。

  5. 选择 Create Project。Looker 会创建项目并在 Looker IDE 中打开该项目。

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

配置模型

使用 LookML 项目页面顶部的 Configure New Model 按钮为现有模型或规划的模型添加配置。

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

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