LookML 项目页面提供了 Looker 实例上的所有 LookML 项目的列表,并显示每个项目中的所有模型。
如需访问 LookML 项目页面,请执行以下步骤:
- 通过选择导航面板中的开发选项,打开开发面板。
- 在开发面板中,选择项目。
查看现有项目及其模型
如需查看现有项目的列表,请前往 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
权限,那么在项目存在之前配置模型会非常有用。由于模型已配置,这些开发者可以在创建项目和该模型后立即运行查询。生成项目后,该项目的列表会移动到 LookML 项目页面的顶部。
待处理项目部分包含以下元素:
- 项目列:此部分列出了已配置但尚未生成的项目。此字段中的项目名称是项目的预期名称。选择项目名称,以显示 New Project 页面,您可以在其中生成该项目。您必须处于开发模式,才能访问新建项目页面。
- 模型列:创建模型配置时指定的模型名称。
- 允许的连接数:模型名称右侧的列显示创建模型配置时此模型允许的连接。
- 配置按钮:配置按钮可让您更改此模型允许的项目名称和连接。
- 添加 LookML 按钮:添加 LookML 按钮会打开该项目的新建项目页面,让您可以使用 LookML 生成器来根据数据库中的一组表自动生成 LookML。
添加和修改配置
如果项目列表旁边有配置按钮,您可以添加或修改项目的模型配置。
如果模型没有配置,当您选择配置时,Looker 会显示配置模型窗口。在配置模型窗口中,您可以指定模型名称、项目名称以及模型可用的连接。
如果模型具有配置,当您选择配置时,Looker 会显示修改模型配置窗口。在修改模型配置窗口中,您可以更改模型可用的连接。
修改模型配置时,您可以查看模型名称,但无法将其重命名。系统会根据在 Looker IDE 中修改模型文件时使用的文件名为模型命名。
在项目字段中,您可以指定模型应与其他项目关联。例如,如果您创建了包含同名模型的新项目,则可以转换模型配置,使其与新项目的模型相关联。
在允许的连接数字段中,您可以将模型限制为使用特定连接的列表,也可以允许模型使用任何连接(当前和未来的所有连接)。
重命名项目
如果您是 Looker 管理员,可以使用项目的项目设置页面更改项目名称。要查看项目设置页面,请打开您的项目,然后从左侧的图标菜单中选择设置图标。
如需重命名项目,请执行以下步骤:
- 确认您已开启开发模式。
- 在 Looker IDE 中导航到您的项目。
- 在项目中,选择 IDE 导航栏中的设置图标,打开项目设置面板。
- 在项目设置面板中选择配置。
- 使用项目配置下的名称字段修改项目名称。
- 在 Project Configuration 页面中向下滚动,然后点击 Save Project Configuration 以保存新项目名称。
删除项目
如果您是 Looker 管理员,则可以使用项目的项目设置页面删除现有项目。要查看项目设置页面,请打开您的项目,然后从左侧的图标菜单中选择设置图标。
已删除的项目不会再出现在 LookML 项目页面的项目部分中,但仍会在已配置的项目部分中显示。
如需移除项目配置,此操作会将项目从开发环境中完全移除,具体操作步骤如下:
- 在 Looker IDE 中导航到您的项目。
- 在您的项目中,选择 IDE 导航栏中的设置图标,打开项目设置面板。
- 在项目设置面板中,选择配置以查看项目配置。
- 在项目配置下,选择删除项目。
- 在删除项目窗口中,验证在删除项目后会丢失的警告和未同步的更改。
- 如果您确定应该删除项目,请在文本框中输入项目名称。要取消操作并导航回您的项目,请使用浏览器的返回按钮。
- 点击永久删除 <项目名称> 按钮。