访问 Looker IDE 的最简单方法是通过 Looker 开发菜单。如需了解详情和其他选项,请参阅访问项目文件。
Looker IDE 支持为项目文件创建文件夹。IDE 的左侧导航窗格中显示文件夹。如果您的 Looker 开发者尚未将您的项目文件整理到文件夹,您的项目将采用扁平化文件结构,文件浏览器面板中按字母顺序列出文件。
以下是一个示例项目,其中开发者为不同类型的项目文件(例如“探索”“模型”和“视图”)添加了文件夹:
您可以在文件浏览器面板顶部的工具栏中选择图标,以收起所有文件夹、移动和删除文件和文件夹、搜索项目文件,或创建新文件夹和新文件。
收起 IDE 边栏
您可以使用键盘快捷键 Command-B (Mac) 或 Ctrl+B (Windows) 或选择文件浏览器图标来显示或隐藏 IDE 文件浏览器:
管理文件和文件夹
左侧面板中的每个文件或文件夹都有一个菜单,其中会显示该项适用的操作。选择文件名右侧的三点状文件夹操作菜单(针对文件夹)或文件操作菜单(针对文件),以打开该菜单。对于名称较长或嵌套在多个文件夹中的内容,您可以通过滚动左侧面板访问菜单。
您可以使用文件浏览器创建文件夹和文件、上传文件以及删除和移动文件和文件夹。有关详情,请参阅管理 LookML 文件和文件夹文档页面。
使用文件夹组织 LookML 文件时,您需要提交更改并将其部署到生产环境,然后其他 Looker 开发者才能看到这些更改。这与您对 LookML 项目所做的任何更改一样。
已导入的项目文件夹
如果您导入项目,Looker IDE 会自动创建一个 imported_projects
文件夹。本地项目和远程项目中的文件都会列在 imported_projects
文件夹中。从 imported_projects
的文件列表中选择导入的项目文件,以查看该文件的内容。
由于 IDE 中批量修改文件以移动或删除这些文件,因此它们无法编辑。
使用 IDE 文件夹整理现有项目
如果您的项目之前采用的是旧版平面文件结构,或者您想重新整理文件夹中的文件,您可以选择保留此结构;但如果您选择将项目文件整理到文件夹中,我们强烈建议您做好以下准备:
- 提前与所有开发者一起规划文件结构。
- 确保所有 Looker 开发者均已将其所有更新部署到生产环境。如果开发者有未部署的更改,其分支将反映上次从生产环境拉取时已存在的文件结构。如果该项目当时采用扁平化文件结构,那么开发者的文件版本将推送到其原始位置的生产环境中,因此您最终会获得该文件的两个副本。此外,如果开发者在迁移到文件夹的过程中有未部署的更改,则在迁移后从生产环境拉取时,开发者会遇到合并冲突。
- 对所有开发者执行临时代码冻结,直到项目完全迁移到新的目录结构。
- 指定一位开发者来移动文件。以下过程假定单个开发者会将项目迁移到 IDE 文件夹。如果您需要让多位开发者移动文件,请在开发者之间拆分任务,以免发生合并冲突。如果遇到合并冲突,请参阅使用版本控制和部署文档页面,了解如何解决合并冲突。
所有开发者都推送并提交了更改并暂停了项目的所有工作后,您便可以将项目迁移到新的目录结构。
指定一位开发者完成以下所有步骤:
- 验证所有开发分支上的所有更新是否已部署到生产环境。其中包括开发者执行 IDE 文件夹迁移的开发分支。
- 验证所有其他开发者是否已停止对项目进行更改。
- 从生产环境中拉取。
- 创建项目的文件夹。
- 将项目文件移动到文件夹中(可以一次一个文件),也可以使用批量修改。
- 验证项目的 LookML。您应该会收到多个 LookML 错误和警告,因为
include
和map_layer
语句使用可能在此过程中转移的文件位置的引用。 更新项目中的所有
include
和map_layer
语句,使其与文件的新路径匹配。此外,您可能还会看到因引用对象的文件路径已更改而无法再被引用的对象的 LookML 验证错误。如需了解详情,请参阅有关将include
与 IDE 文件夹搭配使用和将map_layer
与 IDE 文件夹搭配使用的文档。提交更改。
请告知其他 Looker 开发者,他们现在可以从生产环境中拉取更新,并继续在项目中开发。