LookML 项目页面提供 Looker 实例上所有 LookML 项目的列表,并显示每个项目中的所有模型。
如需访问 LookML 项目页面,请执行以下步骤:
- 在导航面板中选择开发选项,打开开发面板。
- 在 Develop 面板中,选择 Projects。
查看现有项目及其模型
如需查看现有项目的列表,请前往 LookML 项目页面。
在正式版模式下,LookML 项目页面会列出已生成并推送至生产环境的项目。在开发模式下,页面会列出您从生产环境拉取的项目或您在开发模式下自行生成的项目。LookML 项目页面包含以下基本类别:
- 顶部:顶部所列项目已创建,其中可能包含生成的模型和视图文件。如果您是 Looker 管理员,或者对项目中的至少一个模型拥有
develop
权限,则可以在开发面板和页面顶部查看该项目。 - 待处理项目部分:待处理项目部分中列出的项目是指 Looker 管理员已为模型配置允许的连接,但 Looker 开发者尚未生成项目和建模的项目。如果您拥有
develop
权限,则可以查看这些项目。 - Marketplace 项目部分:Marketplace 项目部分中列出的项目是在使用 Looker Marketplace 安装应用、块或插件时创建的。
如需了解如何指定新项目或为现有项目指定新模型,请参阅创建新的 LookML 项目文档页面。
查看项目列表
LookML 项目页面会显示每个项目的以下元素:
- 项目列:项目的名称。每个项目的旁边可能会列出一个或多个模型。选择项目名称以转到该项目的 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 会显示配置模型窗口。在配置模型窗口中,您可以指定模型名称、项目名称以及模型可用的连接。
连接列表仅包含可与模型的项目一起使用的连接。配置为在所有项目中使用的连接具有 (Instance wide)
标签。
如果模型具有配置,当您点击配置时,Looker 会显示修改模型配置窗口。在修改模型配置窗口中,您可以更改模型可用的连接。
修改模型的配置时,您可以查看模型名称,但不能重命名模型。模型根据您在 Looker IDE 中修改模型文件时使用的文件名命名。
在项目字段中,您可以指定模型应与其他项目关联。例如,如果您创建了一个包含同名模型的新项目,则可以转换模型配置,使其与新项目的模型相关联。
在允许的连接字段中,您可以将模型限制为使用特定连接的列表,也可以允许模型使用任何连接(当前和未来的所有连接)。
重命名项目
如果您是 Looker 管理员,则可以使用项目的项目设置页面更改项目名称。如需查看 Project Settings 页面,请打开项目,然后点击 IDE 导航栏中的 Settings 图标 。
如需重命名项目,请执行以下步骤:
- 确认您已开启开发模式。
- 在 Looker IDE 中前往您的项目。
- 在项目中,点击 IDE 导航栏中的 Settings 以打开项目设置面板。
- 在项目设置面板中选择 Configuration。
- 使用 Project Configuration 下的 Name 字段修改项目名称。
- 在项目配置页面中,点击保存项目配置以保存新项目名称。
删除项目
如果您是 Looker 管理员,则可以通过现有项目的项目设置页面删除该项目。如需查看 Project Settings 页面,请打开项目,然后点击 IDE 导航栏中的 Settings 图标 。
已删除的项目不再显示在 LookML 项目页面的项目部分中,但仍会显示在已配置的项目部分中。
如需移除项目配置(这会从开发环境中完全移除项目),请执行以下操作:
- 在 Looker IDE 中前往您的项目。
- 在项目中,点击 IDE 导航栏中的 Settings 以打开 Project Settings 面板。
- 在项目设置面板中,选择配置以查看项目配置。
- 在项目配置下,选择删除项目。
- 在 Delete Project 窗口中,验证是否显示警告以及删除项目后会丢失的未同步更改。
- 如果您确定应删除该项目,请在该字段中输入该项目的名称。要取消操作并返回到您的项目,请使用浏览器的返回按钮。
- 点击永久删除 <项目名称>按钮。