管理 LookML 文件和文件夹

LookML 项目文件会整理到 Looker IDE 的文件浏览器部分的文件夹中。本页介绍了如何在 LookML 项目中创建和管理文件夹和文件。

如需了解 LookML 项目中每种文件类型的结构和用途,请参阅 LookML 项目中文件类型文档页面。

准备工作:重要的文件和文件夹命名惯例

在创建文件和文件夹时,最好牢记以下命名惯例:

  • 区分大小写LookML 区分大小写。为文件夹命名时,请务必遵循项目的惯例。例如,如果您的惯例是使用项目中的所有小写字母,则需要将文件夹命名为 views,而不是 Views。这在您需要指定文件的路径时(例如在包括文件时)会有所不同。通常,在为 LookML 对象和文件夹命名时最好始终使用小写字母。
  • 空格和特殊字符:文件名不能包含空格或以下任何字符:/ ? * : | " < > %
  • 文件扩展名通过 Looker IDE 创建 LookML 文件时,如果您未手动添加扩展名,Looker 会自动将 .lkml 扩展名添加到文件名末尾。例如,如果您输入文件名 flights_data_tests,Looker 会将该文件命名为 flights_data_tests.lkml
  • 更改 LookML 对象的显示名称:如果您要更改模型或 LookML 对象的显示名称,请考虑使用 label 参数或 alias 参数,而不是重命名文件或对象。labelalias 参数会更改显示的名称,同时保留用于电子邮件或其他系统的底层网址。一般情况下,您应该采取一些预防措施,以尽可能确保模型更改不受干扰。如果您确实需要重命名模型或对象,请使用内容验证器更新对模型或对象的所有引用。

创建文件夹

您可以为不同类型的文件(例如查看文件模型文件)创建文件夹。您甚至可以创建子文件夹,如果您想include一部分视图,这种方法非常有用。

要创建文件夹,请执行以下操作:

  1. 从相应菜单中选择创建文件夹选项:
    • 如需在目录结构顶层创建新文件夹,请使用添加文件或文件夹菜单,选择文件浏览器面板顶部的 +(加号)图标即可访问此菜单。
    • 如要在现有文件夹下创建新的子文件夹,请使用现有文件夹的三点状文件夹选项菜单。
  2. 为新文件夹输入名称。
  3. 选择创建

新文件夹会添加到导航窗格中。

创建文件

创建新项目时,您可以基于数据库自动生成模型文件并查看文件。对于现有项目,您可以手动创建新文件。

如需在 LookML 项目中创建新文件,请执行以下操作:

  1. 选择相应的菜单:

    • 如需在目录结构顶层创建新文件,请使用添加文件或文件夹菜单,选择文件浏览器面板顶部的 +(加号)图标即可访问此菜单。
    • 如要在现有文件夹下创建新文件,请使用现有文件夹的三点状文件夹选项菜单。
  2. 选择要创建的 LookML 文件类型。选择下列链接,详细了解每类文件。您可以创建以下类型的文件:

  3. 创建文件弹出式窗口中,输入新文件的名称。如需了解文件的命名限制和准则,请参阅关于创建文件和文件夹的重要说明

  4. 选择创建。新文件即会显示在其中创建。如有需要,您可以轻松将其移至其他文件夹

创建视图文件的注意事项

大多数 LookML 开发者一开始会构建一个或多个查看文件,这些文件是根据数据库中的一组表生成时自动生成的。不过,除了本页面所述的用于创建空白视图文件上传文件的方法之外,处于开发模式的 Looker 开发者还可以通过多种方式向 LookML 项目添加视图文件:

如需使用新视图,请使用 explore 参数将其添加到您的模型文件中,或者使用 join 参数将它添加到模型文件中的现有“探索”中。

从现有数据库表添加新视图

开发模式下,您可以基于现有的数据库表创建视图文件。

  1. 在项目中,选择 Looker IDE 项目文件列表顶部的 +(加号),然后选择添加文件或文件夹菜单;或者,您也可选择文件夹的菜单,在该文件夹中创建文件

  2. 选择基于表格创建视图

  3. Looker 会显示与您的某个连接相关联的表的列表。要更改连接,请使用左上角的连接下拉菜单。

  4. 勾选表格名称左侧的复选框,以选择要用来创建数据视图的所有表格。您可以收起和展开此列表中的数据库或架构,以访问所有可用的表。

  5. 滚动到页面底部,然后选择创建数据视图

  6. Looker 为所有表列生成包含 LookML 的视图。

上传文件

您也可以在计算机上上传文件。如果您在计算机上本地创建了 JSON 数据文件或 LookML 文件,上述做法会非常有用。

如需将文件上传到您的项目,请使用 Looker IDE 中的拖放函数:

  1. 前往您的项目文件
  2. 将文件从计算机拖动到 Looker IDE 中。该文件将显示在目录结构的根目录下。
  3. 文件上传完毕后,将相应内容移至其他文件夹

删除文件和文件夹

从 IDE 左侧面板的三点状文件选项菜单中选择删除,即可删除文件夹或文件。

当您删除某个文件夹时,IDE 会显示确认弹出式窗口。弹出式窗口会指定删除操作包含多少项,包括文件夹及其中的所有文件。

批量删除文件和文件夹

要批量删除文件夹和文件,请按以下步骤操作:

  1. 选择文件浏览器面板顶部的批量修改图标。

  2. 选择要删除的项。所选文件的数量会显示在 Select Files 标题旁边。

    • 若要选择或取消选择个别文件,请展开其文件夹,然后选中文件名旁边的复选框。
    • 若要选中或取消选中整个文件夹及其内容,请选中文件夹名称旁边的复选框。
    • 如需选择目录列表的整个部分,请按 Shift 键。选中范围内顶部内容对应的复选框,然后按住 Shift 键并选中列表中最后一项所对应的复选框。系统会选择这两者之间的所有项。您还可以按住 Shift 键并点击某个项,以选择该项以及目录列表中所有内容。
  3. 选择删除内容回收站图标。Android Studio 随后将显示一个列出所选项目的弹出式菜单。

  4. 选择是,删除以确认删除的内容,或者选择取消返回所选项。

  5. 选择选择文件标题中的 X 以退出批量修改模式。

在文件夹项目中移动内容

您可以将单个文件或整个文件夹及其所有内容拖放到新位置:

将文件或文件夹拖放到另一个文件夹中。目标文件夹无需展开即可接收其他文件夹或文件。当您将鼠标悬停在某个文件夹上时,系统会自动将其展开。

批量移动文件和文件夹

要批量移动文件夹和文件,请按以下步骤操作:

  1. 选择文件浏览器面板顶部的批量修改图标。

  2. 选择要移动的内容。所选文件的数量会显示在 Select Files 标题旁边。

    • 若要选择或取消选择个别文件,请展开其文件夹,然后选中文件名旁边的复选框。
    • 若要选中或取消选中整个文件夹及其内容,请选中文件夹名称旁边的复选框。
    • 如需选择目录列表的整个部分,请按 Shift 键。选中范围内顶部内容对应的复选框,然后按住 Shift 键并选中列表中最后一项所对应的复选框。系统会选择这两者之间的所有项。您还可以按住 Shift 键并点击某个项,以选择该项以及目录列表中所有内容。
  3. 选择移动内容文件夹图标以选择选项。Android Studio 随即会显示文件夹选择弹出式菜单。

  4. 移至弹出式菜单中,为所选内容选择一个文件夹,或者选择新建文件夹以创建新文件夹。项目名称会在下一个菜单页面顶部显示您选择的文件夹的文件路径。如要将内容移至项目的根目录,请选择移动,无需选择文件夹。

  5. 选择移动以确认所选目的地,通过选择新建文件夹在所选文件夹中创建新文件夹,或者在文件路径中选择项目名称链接来返回主文件夹选项菜单。

  6. 选择选择文件标题中的 X 以退出批量修改模式。