管理 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 对象的显示名称,请考虑使用 labelalias 参数,而不是重命名文件或对象。labelalias 参数可更改显示名称,同时保留用于电子邮件或其他系统的底层网址。一般来说,您应采取预防措施,使模型更改尽可能非侵入。如果您确实需要重命名模型或对象,请使用内容验证器更新对模型或对象的所有引用。

创建文件夹

您可以针对不同的文件类型(例如查看文件模型文件)创建文件夹。您甚至可以创建子文件夹,这对于include部分数据视图非常有用。

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

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

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

创建文件

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

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

  1. 选择相应的菜单:

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

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

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

创建视图文件的注意事项

大多数 LookML 开发者会首先创建一个或多个视图文件,当 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 的左侧面板中,从项目的三点状 File Options 菜单中选择 Delete,以删除文件夹或文件。

当您删除文件夹时,IDE 会显示弹出式确认窗口。弹出式窗口会说明删除操作包含的内容数量,包括该文件夹及其中的所有文件。

批量删除文件和文件夹

如需批量删除文件夹和文件,请执行以下操作:

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

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

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

  4. 选择是,删除确认要删除的项,或选择取消返回项选择。

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

在文件夹项目中移动项目

要移动文件,请将文件或文件夹拖放到另一个文件夹。

目标文件夹无需展开即可接收其他文件夹或文件。当您将鼠标悬停在文件夹上时,文件夹会自动展开。

批量移动文件和文件夹

如需批量移动文件夹和文件,请执行以下操作:

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

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

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

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

  5. 选择 Move 以确认所选目标,通过选择 New Folder 在所选文件夹中创建新文件夹,或选择文件路径中的项目名称链接以返回主文件夹选项菜单。

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