LookML 项目页面会列出 Looker 实例上的所有 LookML 项目，并显示每个项目中的所有模型。
如需访问 LookML 项目页面，请执行以下步骤：
- 在导航面板中选择 Develop 选项，打开 Develop 面板。
- 在开发面板中，选择项目。
创建项目
本文档页面假定您已使用以下任一方法创建了项目：
查看现有项目及其模型
如需查看现有项目的列表，请前往 LookML 项目页面。
在正式版模式下，LookML 项目页面会列出已生成并推送到正式版的项目。在开发模式下，此页面会列出您从正式版中拉取的项目或您在开发模式下自行生成的项目。LookML 项目页面包含以下基本类别：
- 顶部部分：顶部部分列出的项目已创建，可能包含生成的模型和视图文件。如果您是 Looker 管理员，或者您对项目中至少一个模型拥有
develop权限，则可以在开发面板和页面顶部看到该项目。 - 待处理的项目部分：待处理的项目部分中列出的项目是指 Looker 管理员已为模型配置了允许的连接，但 Looker 开发者尚未添加 LookML。如果您拥有
develop权限，则可以查看这些项目。 - Marketplace Projects 部分：Marketplace Projects 部分中列出的项目是在使用 Looker Marketplace 安装应用、屏蔽程序或插件时创建的。
如需了解如何为现有项目指定新项目或新模型，请参阅生成模型文档页面。
查看项目的详情
LookML 项目页面会显示每个项目的以下元素：
- Project 列：项目的名称。每个项目旁边都可能列出一个或多个模型。选择项目名称以前往该项目的 LookML。
- Models 列：给定项目的一组 LookML 模型文件。如果您的开发模式环境与生产环境不同，此列表可能会在开发模式和生产模式之间发生变化。例如，您可能在开发模式下创建了一个新模型，但尚未将其推送到生产环境。
- “配置问题”列：如果模型存在问题，该模型会显示一个状态，指明配置存在问题。
- 配置按钮：如果项目有配置按钮，则表示您可以为该项目添加或修改模型配置。
如果模型存在问题，模型会显示一个状态，指明配置存在问题。
| 问题 | 说明 |
|---|---|
| LookML 模型文件尚不存在 | 如果有人在此页面上配置了模型，但尚未为其创建相应的 LookML 文件，您就会看到此问题。 |
| 需要配置才能使用 | 如果有人在现有项目中创建了新的 LookML 模型文件，但尚未在此页面上对其进行配置，您就会看到此问题。 |
| 连接“x”不存在 | 模型文件中声明的 connection 不存在（例如，有人拼写错误或尚未创建该文件）。 |
| 模型“x”不得使用连接“y” | 根据此页面上的配置，模型文件中声明的 connection 不允许。 |
| 项目“y”中已配置一个名为“x”的模型 | 在 Looker 实例中，模型名称必须是唯一的，即使它们位于不同的项目中也是如此。 |
查看 Marketplace 项目的详情
LookML 项目页面的 Marketplace 项目部分列出了在安装 Marketplace 应用、版块或插件期间创建的项目。每个购物平台项目的详情包含以下元素：
- 商品详情：指指向 Looker Marketplace 中应用、组成块或插件商品详情的链接。
- 项目：项目的名称。您可以点击项目名称以查看或修改其 LookML。
- 查看 LookML 或修改 LookML 按钮：您可以选择购物平台块的只读核心项目的 View LookML 按钮，或选择其配置项目的 Edit LookML 按钮（后者可以进行自定义），以前往购物平台项目。如需详细了解如何自定义购物平台广告展示区域，请参阅 Customizing Looker Marketplace Blocks（自定义 Looker 购物平台广告展示区域）文档页面。
- Models：给定项目的一组 LookML 模型文件。
- 配置按钮：如果项目列表旁边有配置按钮，则表示您可以添加或修改项目的模型配置。
查看待处理项目的详情
待处理的项目部分包含已配置但尚未生成或手动定义 LookML 的项目和模型。
如果您有开发者未获得 manage_models 或 manage_project_models 权限，则在项目存在之前配置模型会很有用。由于模型已配置完毕，因此这些开发者只需创建项目和该模型，即可立即运行查询。生成项目后，该项目的列表会移至 LookML 项目页面的顶部部分。
待处理的项目部分包含以下元素：
- Project（项目）列：此部分列出了已配置但尚未生成的项目。此字段中的项目名称是项目的预期名称。选择项目名称以显示新建项目页面，您可以在其中生成该项目。您必须处于开发模式才能前往新建项目页面。
- 模型列：创建模型配置时指定的模型名称。
- “允许的连接”列：模型名称右侧的列会显示在创建模型配置时为此模型允许的连接。
- 配置按钮：借助配置按钮，您可以更改项目名称以及允许与此模型建立的连接。
- 添加 LookML 按钮：添加 LookML 按钮会打开相应项目的新建项目页面，您可以在该页面中自动生成 LookML，该 LookML 基于数据库中的一组表。
添加和修改模型配置
如果现有项目的详情旁边显示了配置按钮，则表示您可以添加或修改该项目的模型配置。
如果模型没有配置，当您点击配置时，Looker 会显示配置模型窗口。在配置模型窗口中，您可以指定模型名称、项目名称以及可供模型使用的连接。
连接列表仅包含可与模型的项目搭配使用的连接。配置为在所有项目中使用的连接带有 (Instance wide) 标签。
您还可以点击项目页面顶部的配置新模型按钮，打开配置模型窗口。在这种情况下，您可以使用配置模型窗口创建和配置新模型。新模型不会包含任何 LookML，但会与连接相关联。如需完成此过程，请在模型字段中为模型输入新名称，并在项目字段中填写新名称或选择与模型相同的名称，选择连接，然后点击保存。稍后，您或其他 Looker 开发者可以向新项目添加 LookML 来定义模型。
如果模型具有配置，当您点击配置时，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，则可以在项目的项目配置页面中更改 LookML 项目的名称。非管理员 Looker 开发者可以查看项目配置页面，但无法更改该页面上的选项。
如需重命名项目，请执行以下步骤：
- 确认您已开启开发者模式。
- 在 Looker IDE 中前往您的项目。
- 在项目中，点击 IDE 导航栏中的 Settings（设置）图标 ，打开项目设置面板。
- 在项目设置面板中，选择配置。
- 使用项目配置下的名称字段修改项目的名称。
- 在项目配置页面中，点击保存项目配置以保存新项目名称。
删除项目
如果您是 Looker 管理员，则可以使用项目的项目设置删除现有项目。如需查看项目设置，请打开项目，然后点击 IDE 导航栏中的设置 。
已删除的项目不会再显示在 LookML 项目页面的项目部分中，但仍会显示在已配置的项目部分中。
如需移除项目配置（这会将项目从开发环境中完全移除），请执行以下操作：
- 在 Looker IDE 中前往您的项目。
- 在项目中，点击 IDE 导航栏中的 Settings（设置）图标 ，打开项目设置面板。
- 在项目设置面板中，选择配置以查看项目配置。
- 在项目配置下，选择删除项目。
- 在删除项目窗口中，查看警告以及删除项目后会丢失的未同步更改。
- 如果您确定要删除该项目，请在该字段中输入项目的名称。如需取消操作并返回到项目，请使用浏览器的返回按钮。
- 点击 Permanently Delete <project name> 按钮。