访问和修改项目信息

LookML 项目页面提供了 Looker 实例上所有 LookML 项目的列表,并显示每个项目中的所有模型。

如需访问 LookML 项目页面,请执行以下步骤:

  1. 导航面板中选择开发选项,以打开开发面板。
  2. 开发面板中,选择项目

查看现有项目及其模型

如需查看现有项目的列表,请前往 LookML 项目页面。

在生产模式下,LookML 项目页面会列出已生成并推送到生产环境的项目。在开发模式下,该页面会列出从生产环境中拉取或您在开发模式下自行生成的项目。LookML 项目页面包含以下基本类别:

如需了解如何为现有项目指定新项目或新模型,请参阅创建新的 LookML 项目文档页面。

查看项目列表

LookML 项目页面会显示每个项目的以下元素:

  • 项目列:项目的名称。每个项目旁边可能包含一个或多个模型。选择项目名称以导航到该项目的 LookML。
  • 模型列:指定项目的一组 LookML 模型文件。如果您的开发模式环境与生产环境不同,则此列表可以在开发模式和生产模式之间切换。例如,您可能在开发模式下创建了一个尚未推送到生产环境的新模型。
  • “配置问题”列:如果某个模型有问题,该模型会显示指示配置问题的状态。
  • 配置按钮:如果配置按钮可用于某个项目,您可以为该项目添加或修改模型配置

如果某个模型存在问题,该模型会显示指示配置问题的状态。

问题 解释
LookML 模型文件尚不存在 如果有人在此页面上配置了模型,但尚未为其创建相应的 LookML 文件,您就会看到此问题。
需要配置才能使用 如果有人在现有项目中创建了新的 LookML 模型文件,但尚未在此页面上对其进行配置,您就会看到此问题。
连接“x”不存在 模型文件中声明的 connection 不存在(例如有人拼错了它或尚未创建它)。
模型“x”不能使用连接“y” 根据本页面中的配置,模型文件中声明的 connection 不受支持。
项目“y”中已配置名为“x”的模型 模型名称在 Looker 实例中必须是唯一的,即使模型位于不同的项目中也是如此。

查看 Marketplace 项目的列表

LookML 项目页面的 Marketplace 项目部分列出了在安装 Marketplace 应用、屏蔽设置或插件期间创建的项目。每个 Marketplace 项目的列表都包含以下元素:

  • 商品详情:指向 Looker Marketplace 中的应用、屏蔽项或插件商品详情的链接。
  • Project:项目的名称。您可以点击项目名称以查看或修改其 LookML。
  • 查看 LookML修改 LookML 按钮:如需前往 Marketplace 项目,您可以选择 Marketplace 块的只读核心项目的查看 LookML 按钮,或选择其配置项目的修改 LookML(后者可以自定义)。如需详细了解如何自定义 Marketplace 屏蔽设置,请参阅自定义 Looker Marketplace 屏蔽设置文档页面。
  • 模型:指定项目的一组 LookML 模型文件。
  • 配置按钮:如果项目列表旁边有配置按钮,那么您可以添加或修改项目的模型配置

查看待处理项目的列表

待处理项目部分包含已配置有项目名称但尚未生成的模型。因此,待处理项目部分包含仅配置且尚无任何 LookML 的项目和模型。

如果您的开发者尚未获得 manage_modelsmanage_project_models 权限,则在项目存在之前配置模型会非常有用。由于已配置模型,因此这些开发者可以在创建项目和模型后立即运行查询。生成项目后,该项目的列表会移至 LookML 项目页面的顶部。

待处理项目部分包含以下元素:

  • 项目列:此部分会列出已配置但尚未生成的项目。此字段中的项目名称是项目的预期名称。选择项目名称以显示新建项目页面,您可以在该页面生成该项目。您必须处于开发模式才能进入 New Project 页面。
  • 模型列:创建模型配置时指定的模型名称。
  • “允许的连接”列:模型名称右侧的列显示的是在创建模型配置时此模型允许的连接。
  • 配置按钮:您可以使用配置按钮更改项目名称以及此模型允许的连接。
  • 添加 LookML 按钮:点击添加 LookML 按钮会打开该项目的新建项目页面,让您可以使用 LookML 生成器根据数据库中的一组表自动生成 LookML

添加和修改配置

如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。

如果模型没有配置,当您点击配置时,Looker 会显示配置模型窗口。在 Configure a Model 窗口中,您可以指定模型名称、项目名称以及可用于模型的连接。

连接列表仅包含可用于模型项目的连接。配置为在所有项目中使用的连接带有 (Instance wide) 标签。

如果模型具有配置,当您点击配置时,Looker 会显示修改模型配置窗口。在修改模型配置窗口中,您可以更改可用于模型的连接。

修改模型的配置时,您可以查看模型名称,但无法重命名。模型根据您在 Looker IDE 中修改模型文件时使用的文件名命名。

项目字段中,您可以指定模型应与其他项目关联。例如,如果您创建了一个包含同名模型的新项目,则可以将模型配置转换为与新项目的模型相关联。

允许的连接字段中,您可以将模型限制为使用一系列特定连接,也可以允许模型使用任何连接(所有当前和未来的连接)。

重命名项目

Looker 管理员创建 LookML 项目时,会提供一个项目名称。项目名称应被视为项目的永久 ID,因为 Looker 通过以下方式使用项目名称:

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

如果您拥有 Looker manage_models 权限,则可以使用相应项目的项目设置页面更改相应项目的名称。非管理员的 Looker 开发者可以查看项目设置页面,但无法更改页面上的选项。

如需重命名项目,请执行以下步骤:

  1. 确认您已开启开发模式
  2. 在 Looker IDE 中前往您的项目
  3. 在项目中,点击 IDE 导航栏中的 Settings ,打开项目设置面板。
  4. 在项目设置面板中选择配置
  5. 使用 Project Configuration 下的 Name 字段来修改项目的名称。
  6. Project Configuration 页面中,点击 Save Project Configuration 以保存新项目名称。

删除项目

如果您是 Looker 管理员,则可以通过项目的项目设置页面删除现有项目。如需查看 Project Settings 页面,请打开您的项目,然后点击 IDE 导航栏中的 Settings

已删除的项目不会再显示在 LookML 项目页面的项目部分中,但仍会显示在已配置的项目部分中。

如需移除项目配置(从开发环境中完全移除项目),请执行以下操作:

  1. 在 Looker IDE 中前往您的项目
  2. 在项目中,点击 IDE 导航栏中的 Settings ,以打开 Project Settings 面板。
  3. 在项目设置面板中,选择配置以查看项目配置。
  4. 项目配置下,选择删除项目
  5. Delete Project 窗口中,验证警告和因项目被删除而丢失的未同步更改。
  6. 如果您确定应该删除项目,请在字段中输入项目的名称。如需取消操作并返回到您的项目,请使用浏览器的返回按钮。
  7. 点击永久删除 <项目名称> 按钮。