您可以通过 Looker 开发菜单访问 Looker IDE。如需了解详情和其他选项,请参阅访问项目文件。
Looker IDE 支持为项目文件创建文件夹。文件夹显示在 IDE 的左侧导航窗格中。
如果您的 Looker 项目未整理到文件夹中,那么项目将采用平面文件结构,文件会按字母顺序列在文件浏览器面板中。请参阅使用 IDE 文件夹组织现有项目,了解如何将项目更新为使用 IDE 文件夹。
Looker IDE 会保留您当前打开的文件以及文件浏览器面板的已展开或收起状态。您可以在 IDE 设置中重置保留类型。
您可以选择 File Browser 面板顶部工具栏中的图标,以收起所有文件夹、移动和删除文件和文件夹、搜索项目文件,或创建新文件夹和新文件。
“导入的项目”文件夹
如果您导入项目,Looker IDE 会自动创建一个 imported_projects
文件夹。imported_projects
文件夹中列出了本地项目和远程项目中的文件。从 imported_projects
中的文件列表中选择一个导入的项目文件,以查看该文件的内容。
由于无法修改,因此当您在 IDE 中批量修改文件以移动或删除这些文件时,导入的项目文件不会显示。
使用 IDE 文件夹整理现有项目
如果您的项目之前采用的是旧版扁平文件结构,或者您想在文件夹中重新整理文件,则可以选择保留此结构;但如果您选择将项目文件整理到文件夹中,我们强烈建议您做好以下准备:
- 提前与所有开发者一起规划文件结构。
- 确保您的所有 Looker 开发者都已将所有更新部署到生产环境。如果开发者有未部署的更改,则其分支将反映上次从生产环境中提取时存在的文件结构。如果项目当时采用的是扁平文件结构,开发者的文件版本将推送到生产环境的原始位置,因此您最终会得到该文件的两个副本。此外,如果开发者在向文件夹迁移的过程中取消部署了更改,那么在迁移后从生产环境拉取时,将面临合并冲突。
- 在项目完全迁移到新目录结构之前,请让所有开发者暂时冻结代码。
- 将文件移动任务分配给单个开发者。以下过程假定单个开发者将项目迁移到 IDE 文件夹。如果您需要让多个开发者移动文件,请在开发者之间分配任务,以避免合并冲突。如果您确实遇到了合并冲突,请参阅使用版本控制和部署文档页面,了解如何解决这些冲突。
当所有开发者推送并提交他们的更改并暂停项目中的所有工作后,您就可以将项目迁移到新的目录结构。
将所有以下步骤分配给单个开发者:
- 验证所有开发分支上的所有更新是否已部署到生产环境。这包括执行向 IDE 文件夹迁移的开发者的开发分支。
- 确认所有其他开发者都已停止对项目进行更改。
- 从生产环境中拉取。
- 创建项目的文件夹。
- 将项目文件移动到文件夹中,可以一次一个文件或使用批量修改。
- 验证项目的 LookML。由于
include
和map_layer
语句使用了对文件位置的引用,而这些文件位置在执行此过程期间可能会被移动,因此您应该会收到多个 LookML 错误和警告。 更新项目中的所有
include
和map_layer
语句,以匹配文件的新路径。此外,如果引用的对象因文件路径已更改而无法再找到,您可能会看到 LookML 验证错误。如需了解详情,请参阅有关将include
与 IDE 文件夹搭配使用和将map_layer
与 IDE 文件夹搭配使用的文档。提交更改。
请通知其他 Looker 开发者,他们现在可以从生产环境中提取更新并继续在项目中开发了。