使用 IDE 文件浏览器

如需访问 Looker IDE,最简单的方法是使用 Looker 开发菜单。如需了解详情和其他选项,请参阅访问项目文件

Looker IDE 支持使用文件夹存储项目文件。文件夹显示在 IDE 的左侧导航窗格中。如果您的 Looker 开发者尚未将项目文件整理到文件夹中,那么您的项目将采用平面文件结构,文件按字母顺序列在文件浏览器面板中。

在下面的示例项目中,开发者为不同类型的项目文件(例如“探索”“模型”和“视图”)添加了文件夹:

示例项目,具有一个包含模型文件的 Models 文件夹和一个包含项目视图文件的 View 文件夹。

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

收起 IDE 边栏

您可以通过使用键盘快捷键 Command-B (适用于 Mac)或 Ctrl+B (适用于 Windows)或选择文件浏览器图标来显示或隐藏 IDE 文件浏览器:

在 IDE 边栏中选择“文件浏览器”可收起或展开文件浏览器。

管理文件和文件夹

左侧面板中的每个文件或文件夹都有一个菜单,显示该项可执行的操作。选择文件名右侧的三点状文件夹操作菜单(针对文件夹)或文件操作菜单(针对文件),打开该菜单。对于名称较长的内容或嵌套在多个文件夹中的内容,您可以通过在左侧面板中滚动来访问菜单。

您可以使用文件浏览器创建文件夹和文件、上传文件,以及删除和移动文件和文件夹。如需了解详情,请参阅管理 LookML 文件和文件夹文档页面。

使用文件夹整理 LookML 文件时,您需要先提交更改将更改部署到生产环境,然后其他 Looker 开发者才能看到这些更改。这就像您对 LookML 项目所做的任何更改一样。

导入的项目文件夹

如果您导入项目,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 开发者,他们现在可以从生产环境中提取更新并继续在项目中开发了。