LookML 项目页面提供 Looker 实例上所有 LookML 项目的列表,并显示每个项目中的所有模型。
如需访问 LookML 项目页面,请执行以下步骤:
- 在导航面板中选择开发选项,以打开开发面板。
- 在开发面板中,选择项目。
查看现有项目及其模型
如需查看现有项目的列表,请前往 LookML 项目页面。
在正式版模式下,LookML 项目页面会列出已生成并推送到正式版的项目。在开发模式下,此页面会列出您从正式版中拉取的项目或您在开发模式下自行生成的项目。LookML 项目页面包含以下基本类别:
- 顶部部分:顶部部分列出的项目已创建,可能包含生成的模型和视图文件。如果您是 Looker 管理员,或者您对项目中的至少一个模型拥有
develop
权限,则可以在开发面板和页面顶部看到该项目。 - 待处理项目部分:待处理项目部分中列出的项目是指 Looker 管理员为模型配置了允许的关联,但 Looker 开发者尚未生成项目和建模的项目。如果您拥有
develop
权限,则可以查看这些项目。 - Marketplace Projects 部分:Marketplace Projects 部分中列出的项目是在使用 Looker Marketplace 安装应用、屏蔽程序或插件时创建的。
如需了解如何为现有项目指定新项目或新模型,请参阅创建新的 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 版块的只读核心项目的 View LookML 按钮,或选择其配置项目的 Edit LookML 按钮(后者可以进行自定义),以前往 Marketplace 项目。如需详细了解如何自定义 Marketplace 屏蔽设置,请参阅自定义 Looker Marketplace 屏蔽设置文档页面。
- 模型:指定项目的一组 LookML 模型文件。
- 配置按钮:如果项目列表旁边有配置按钮,那么您可以添加或修改项目的模型配置。
查看待处理项目的列表
待处理的项目部分包含已配置项目名称但尚未生成的模型。因此,“待处理的项目”部分包含仅配置过且尚无任何 LookML 的项目和模型。
如果您的开发者尚未获得 manage_models
或 manage_project_models
权限,则在项目存在之前配置模型会非常有用。由于模型已配置完毕,因此这些开发者只需创建项目和该模型,即可立即运行查询。生成项目后,该项目的列表会移至 LookML 项目页面的顶部部分。
待处理的项目部分包含以下元素:
- 项目列:此部分会列出已配置但尚未生成的项目。此字段中的项目名称是项目的预期名称。选择项目名称以显示新建项目页面,您可以在其中生成该项目。您必须处于开发模式才能进入 New Project 页面。
- 模型列:创建模型配置时指定的模型名称。
- “允许的连接”列:模型名称右侧的列显示的是在创建模型配置时此模型允许的连接。
- 配置按钮:您可以使用配置按钮更改项目名称以及此模型允许的连接。
- 添加 LookML 按钮:添加 LookML 按钮会打开相应项目的新建项目页面,以便您使用 LookML 生成器自动生成 LookML,该生成器基于数据库中的一组表生成 LookML。
添加和修改配置
如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。
如果模型没有配置,当您点击配置时,Looker 会显示配置模型窗口。在配置模型窗口中,您可以指定模型名称、项目名称以及可供模型使用的连接。
连接列表仅包含可用于模型项目的连接。配置为在所有项目中使用的连接带有 (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
。
如果您拥有“查看者”权限 manage_models
,则可以在项目的项目配置页面中更改 LookML 项目的名称。非管理员 Looker 开发者可以查看项目配置页面,但无法更改该页面上的选项。
如需重命名项目,请按以下步骤操作:
- 确认您已开启开发模式。
- 在 Looker IDE 中前往您的项目。
- 在项目中,点击 IDE 导航栏中的 Settings ,打开项目设置面板。
- 在项目设置面板中选择配置。
- 使用项目配置下的名称字段修改项目的名称。
- 在项目配置页面中,点击保存项目配置以保存新项目名称。
删除项目
如果您是 Looker 管理员,则可以使用项目的项目设置删除现有项目。如需查看项目设置,请打开您的项目,然后点击 IDE 导航栏中的 Settings 。
已删除的项目不会再显示在 LookML 项目页面的项目部分中,但仍会显示在已配置的项目部分中。
如需移除项目配置(从开发环境中完全移除项目),请执行以下操作:
- 在 Looker IDE 中前往您的项目。
- 在项目中,点击 IDE 导航栏中的 Settings ,打开项目设置面板。
- 在项目设置面板中,选择配置以查看项目配置。
- 在项目配置下,选择删除项目。
- 在删除项目窗口中,查看警告以及删除项目后会丢失的未同步更改。
- 如果您确定要删除该项目,请在该字段中输入项目的名称。如需取消操作并返回到项目,请使用浏览器的返回按钮。
- 点击 Permanently Delete <project name> 按钮。