使用 IDE 文件浏览器

您可以在 Looker IDE 中使用文件夹,更有效地整理 Looker 项目文件。文件夹可防止出现扁平的按字母顺序排序的文件结构,从而更轻松地管理和浏览复杂项目。您可以通过 Looker 开发 菜单访问 Looker IDE。文件夹显示在 IDE 的左侧导航窗格中。如需了解详情以及访问项目文件的其他选项,请参阅访问项目文件

Looker IDE,其中文件浏览器显示了示例项目中的文件夹。

如果您的 Looker 项目未整理到文件夹中,则您的项目将具有扁平的文件结构,文件按字母顺序列在文件浏览器 面板中。如需了解如何更新项目以使用 IDE 文件夹,请参阅使用 IDE 文件夹整理现有项目

Looker IDE 会保留您打开的文件以及文件浏览器 面板的展开或收起状态。您可以在 IDE 设置 中重置保留状态。

您可以选择文件浏览器面板顶部的工具栏中的图标,以收起所有文件夹、移动删除文件和文件夹、搜索项目文件,或创建新文件夹新文件

导入的项目文件夹

如果您导入项目,Looker IDE 会自动创建 imported_projects 文件夹。本地项目和远程项目中的文件都会列在 imported_projects 文件夹中。imported_projects 中的文件列表中选择一个导入的项目文件,即可查看该文件的内容。

由于无法修改导入的项目文件,因此当您在 IDE 中批量修改文件以移动删除这些文件时,这些文件不可见。

使用 IDE 文件夹整理现有项目

如果您的项目之前具有旧版扁平文件结构,或者您想要重新整理文件夹中的文件,可以选择保留此结构;但如果您选择将项目文件整理到文件夹中,我们强烈建议您做好以下准备工作:

  • 与所有开发者提前规划文件结构。
  • 确保所有 Looker 开发者都已将其所有更新部署到生产环境。如果开发者有未部署的更改,其分支将反映上次从生产环境拉取时存在的文件结构。如果项目当时具有扁平文件结构,则开发者的文件版本将推送到生产环境中的原始位置,因此您最终将获得该文件的两个副本。此外,如果开发者在迁移到文件夹期间有未部署的更改,则该开发者在迁移后从生产环境拉取时会遇到合并冲突。
  • 与所有开发者一起暂时冻结代码,直到项目完全迁移到新的目录结构为止。
  • 指定一位开发者来移动文件。以下过程假定一位开发者会将项目迁移到 IDE 文件夹。如果您需要多位开发者移动文件,请将任务分配给开发者,以避免合并冲突。如果您确实遇到合并冲突,请参阅使用版本控制和部署文档页面,了解如何解决这些冲突。

在所有开发者推送并提交更改并暂停对项目的所有工作后,您就可以将项目迁移到新的目录结构。

指定一位开发者来执行以下所有步骤:

  1. 验证所有开发分支上的所有更新是否都已部署到生产环境。这包括执行迁移到 IDE 文件夹的开发者的开发分支。
  2. 验证所有其他开发者是否已停止对项目进行更改。
  3. 从生产环境中拉取
  4. 创建项目的文件夹
  5. 将项目文件移动到文件夹中,可以一次移动一个文件,也可以使用批量修改
  6. 验证项目的 LookML。预计您会遇到多个 LookML 错误和警告,因为 includemap_layer 语句引用了在此过程中可能已移动的文件位置。
  7. 更新项目中的所有 includemap_layer 语句,以与文件的新路径匹配。此外,您可能会看到 LookML 验证错误,因为引用的对象已无法找到,原因是其文件路径已更改。如需了解详情,请参阅有关 include 与 IDE 文件夹搭配使用 以及有关 map_layer 与 IDE 文件夹搭配使用 的文档。

  8. 提交更改

  9. 将更新部署到生产环境

  10. 通知其他 Looker 开发者,他们现在可以从生产环境拉取更新,并继续在项目中进行开发。