使用 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 开发者,他们现在可以从生产环境中提取更新并继续在项目中进行开发。