使用 IDE 文件浏览器

您可以通过 Looker 开发菜单访问 Looker IDE。如需了解详情和其他选项,请参阅访问项目文件

Looker IDE 支持为项目文件创建文件夹。文件夹显示在 IDE 的左侧导航窗格中。

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

如果您的 Looker 项目未整理到文件夹中,那么项目将采用平面文件结构,文件会按字母顺序列在文件浏览器面板中。请参阅使用 IDE 文件夹组织现有项目,了解如何将项目更新为使用 IDE 文件夹。

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

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

“导入的项目”文件夹

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

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

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

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

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

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

将所有以下步骤分配给单个开发者:

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

  8. 提交更改

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

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