LookML 项目页面提供 Looker 实例上所有 LookML 项目的列表,并显示每个项目中的所有模型。
如需访问 LookML 项目页面,请执行以下步骤:
- 在导航面板中选择 Develop 选项,打开 Develop 面板。
- 在 Develop 面板中,选择 Projects。
查看现有项目及其模型
如需查看现有项目的列表,请前往 LookML 项目页面。
在生产模式下,LookML 项目页面会列出已生成并推送到生产环境的项目。在开发模式下,该页面会列出您从生产环境中提取的项目或您在开发模式下自行生成的项目。LookML 项目页面包含以下基本类别:
- 顶部:顶部中列出的项目已经创建,可能包含生成的模型和视图文件。如果您是 Looker 管理员,或者您对项目中至少一个模型的
develop
权限,则可以在开发面板和页面顶部查看该项目。 - 待处理的项目部分:待处理的项目部分中列出的项目是指 Looker 管理员已为模型配置允许的连接,但 Looker 开发者尚未生成项目和建模的项目。如果您拥有
develop
权限,则可以查看这些项目。 - Marketplace 项目部分:Marketplace 项目部分中列出的项目是在使用 Looker Marketplace 安装应用、块或插件时创建的。
如需了解如何指定新项目或为现有项目指定新模型,请参阅创建新的 LookML 项目文档页面。
查看项目列表
LookML 项目页面会针对每个项目显示以下元素:
- Project 列:项目的名称。每个项目旁边可能会列出一个或多个模型。选择项目名称以转到该项目的 LookML。
- 模型列:指定项目的一组 LookML 模型文件。如果您的开发环境与生产环境不同,此列表可在开发模式和生产模式之间切换。例如,您可能在开发模式下创建了一个新模型,但尚未将其推送到生产环境。
- 配置问题列:如果模型存在问题,模型会显示一个状态,指明配置存在问题。
- 配置按钮:如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。
如果模型存在问题,则模型会显示一个状态,指示配置存在问题。
问题 | 说明 |
---|---|
LookML 模型文件尚不存在 | 如果有人在此页面上配置了模型,但尚未为其创建相应的 LookML 文件,就会出现此问题。 |
需要配置才能使用 | 如果有人在现有项目中创建了新的 LookML 模型文件,但尚未在此页面上对其进行配置,您就会看到此问题。 |
连接“x”不存在 | 模型文件中声明的 connection 不存在(例如,有人拼写错误或尚未创建)。 |
模型“x”不得使用连接“y” | 根据本页中的配置,系统不允许使用模型文件中声明的 connection 。 |
项目“y”中已配置一个名为“x”的模型 | 模型名称在您的 Looker 实例中必须是唯一的,即使它们位于不同的项目中也是如此。 |
查看 Marketplace 项目的列表
LookML 项目页面的 Marketplace 项目部分会列出在安装 Marketplace 应用、块或插件期间创建的项目。每个 Marketplace 项目的商品详情都包含以下元素:
- 列表:指向 Looker Marketplace 中相应应用、块或插件的产品详情的链接。
- 项目:项目的名称。您可以点击项目名称以查看或修改其 LookML。
- 查看 LookML 或修改 LookML 按钮:您可以通过以下方式导航到 Marketplace 项目:选择 Marketplace 块的只读核心项目的查看 LookML 按钮,或选择其配置项目修改 LookML(后一个项目可进行自定义)。如需详细了解如何自定义 Marketplace 屏蔽设置,请参阅自定义 Looker Marketplace 屏蔽设置文档页面。
- 模型:给定项目的一组 LookML 模型文件。
- 配置按钮:如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。
查看待处理项目的列表
待处理的项目部分包含已配置具有项目名称但尚未生成的模型。因此,待处理的项目部分包含仅配置但尚未配置任何 LookML 的项目和模型。
如果您的开发者尚未获得 manage_models
或 manage_project_models
权限,那么在项目存在之前配置模型会非常有用。由于模型已经过配置,因此这些开发者可以在创建项目和模型后立即运行查询。生成项目后,该项目的列表会移至 LookML 项目页面的顶部。
待处理的项目部分包含以下元素:
- 项目列:此部分会列出已配置但尚未生成的项目。此字段中的项目名称是项目的预期名称。选择项目名称以显示新建项目页面,您可以在其中生成该项目。您必须处于开发模式才能访问新建项目页面。
- 模型列:创建模型配置时指定的模型名称。
- 允许的连接列:模型名称右侧的列显示了创建模型配置时此模型允许的连接。
- 配置按钮:通过配置按钮,您可以更改项目名称以及此模型允许的连接。
- 添加 LookML 按钮:点击添加 LookML 按钮可打开相应项目的新建项目页面,可让您使用 LookML 生成器基于数据库中的一组表自动生成 LookML。
添加和修改配置
如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。
如果模型没有配置,当您选择配置时,Looker 会显示配置模型窗口。在 Configure a Model 窗口中,您可以指定模型名称、项目名称以及模型可用连接。
连接列表仅包含其连接范围中包含模型项目的连接。如果连接范围设置为所有项目,Looker 会在该连接旁边显示 (Instance wide)
。
如果模型具有配置,当您选择配置时,Looker 会显示修改模型配置窗口。在修改模型配置窗口中,您可以更改模型可用的连接。
修改模型的配置时,您可以查看模型名称,但无法重命名。系统会根据您在 Looker IDE 中修改模型文件时使用的文件名为模型命名。
在项目字段中,您可以指定模型应与其他项目相关联。例如,如果您创建了一个包含同名模型的新项目,则可以转换模型配置,使其与新项目的模型相关联。
在允许的连接字段中,您可以将模型限制为使用特定连接的列表,也可以允许模型使用任何连接(当前和未来的所有连接)。
重命名项目
如果您是 Looker 管理员,则可以使用项目的项目设置页面更改项目名称。如需查看“项目设置”页面,请打开项目,然后从左侧图标菜单中选择“设置”图标。
如需重命名项目,请执行以下步骤:
- 确认您已开启开发模式。
- 在 Looker IDE 中前往您的项目。
- 在项目中,选择 IDE 导航栏中的设置图标以打开项目设置面板。
- 在项目设置面板中选择配置。
- 使用 Project Configuration 下的 Name 字段修改项目名称。
- 在项目配置页面中向下滚动,然后点击保存项目配置以保存新项目名称。
删除项目
如果您是 Looker 管理员,您可以通过项目的项目设置页面删除现有项目。如需查看“项目设置”页面,请打开项目,然后从左侧图标菜单中选择“设置”图标。
已删除的项目不再显示在 LookML 项目页面的项目部分中,但仍显示在已配置的项目部分中。
要移除项目配置(这会从开发环境中完全移除项目),请执行以下操作:
- 在 Looker IDE 中前往您的项目。
- 在项目中,选择 IDE 导航栏中的设置图标以打开 Project Settings 面板。
- 在项目设置面板中,选择配置以查看项目配置。
- 在项目配置下,选择删除项目。
- 在 Delete Project 窗口中,验证是否出现警告以及将项目删除后未同步的更改是否丢失。
- 如果您确定应该删除该项目,请在文本框中输入该项目的名称。如需取消操作并返回到您的项目,请使用浏览器的返回按钮。
- 点击永久删除 <项目名称> 按钮。