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
参数,而不是重命名文件或对象。label
和alias
参数可更改显示名称,同时保留用于电子邮件或其他系统的底层网址。一般来说,您应采取预防措施,使模型更改尽可能非侵入。如果您确实需要重命名模型或对象,请使用内容验证器更新对该模型或对象的所有引用。
创建文件夹
您可以针对不同的文件类型(例如查看文件或模型文件)创建文件夹。您甚至可以创建子文件夹,如果您想include
视图的子集,这非常有用。
要创建文件夹,请执行以下操作:
- 从相应菜单中选择创建文件夹选项:
- 要在目录结构的顶层创建新文件夹,请选择添加文件或文件夹菜单(选择文件浏览器面板顶部的 +(加号)即可访问该菜单)。
- 要在现有文件夹下创建新的子文件夹,请使用现有文件夹的三点状文件夹选项菜单。
- 为新文件夹输入名称。
- 选择创建。
新文件夹会添加到导航窗格中。
创建文件
在创建新项目时,您可以根据数据库自动生成模型文件和视图文件。对于现有项目,您可以手动创建新文件。
如需在 LookML 项目中创建新文件,请执行以下操作:
选择相应的菜单:
- 如需在目录结构的顶层创建新文件,请使用添加文件或文件夹菜单,您可以通过选择文件浏览器面板顶部的 +(加号)图标来访问该菜单。
- 要在现有文件夹下创建新文件,请使用现有文件夹对应的三点状文件夹选项菜单。
选择要创建的 LookML 文件的类型。选择以下列表中的链接,详细了解每种文件类型。您可以创建以下类型的文件:
在创建文件弹出式窗口中,为新文件输入一个名称。如需了解文件命名的限制和准则,请参阅有关创建文件和文件夹的重要说明。
选择创建。新文件会显示在创建它的位置。如有需要,您可以轻松将其移至其他文件夹。
创建视图文件的注意事项
大多数 LookML 开发者会首先创建一个或多个视图文件,当 LookML 项目根据数据库中的一组表生成时,系统会自动创建这些文件。不过,除了本页面介绍的用于创建空白视图文件和上传文件外,处于开发模式的 Looker 开发者还可以通过多种方式向 LookML 项目添加视图文件:
根据数据库中的表创建视图文件:
- 首次连接到数据库时从数据库表生成视图文件,如生成模型文档页面中所述
- 针对已连接到数据库的项目,根据数据库表生成视图文件,如本页面中的从现有数据库表添加新视图部分所述
为派生表创建视图文件:
- 使用本页中介绍的任一选项创建一个空白视图文件,然后手动定义派生表,如创建原生派生表文档页面的在 LookML 中定义原生派生表部分所述
- 让 Looker 根据探索创建派生表 LookML,如创建原生派生表文档页面的使用探索开始定义原生派生表部分中所述
- 让 Looker 根据 SQL Runner 查询创建派生表 LookML,如使用 SQL Runner 创建派生表文档页面中所述
如需使用新视图,请使用 explore
参数将其添加到模型文件中,或使用 join
参数将其与模型文件中的现有“探索”视图联接起来。
从现有数据库表添加新视图
您可以在开发模式下根据现有数据库表创建视图文件。
在项目中,通过选择 Looker IDE 中项目文件列表顶部的 +(加号)来选择添加文件或文件夹菜单,或者您也可以选择文件夹的菜单以在文件夹中创建文件。
选择基于表创建视图。
Looker 会显示与您的某个连接关联的表的列表。要更改连接,请使用左上角的连接下拉菜单。
选中表名称左侧的复选框,以选择要基于哪些表创建视图。您可以收起和展开此列表中的数据库或架构,以访问所有可用表。
滚动到页面底部,然后选择创建视图。
Looker 会为所有表格列生成包含 LookML 的视图。
上传文件
您还可以从计算机将文件上传到您的项目。如果您已在计算机本地创建了 JSON 数据文件或 LookML 文件,此功能将非常有用。
如需将文件上传到您的项目,请使用 Looker IDE 中的拖放功能:
- 前往您的项目文件。
- 将文件从计算机拖动到 Looker IDE。该文件将显示在目录结构的根目录中。
- 文件上传完毕后,将该内容移至其他文件夹。
删除文件和文件夹
在 IDE 的左侧面板中,从项目的三点状 File Options 菜单中选择 Delete,以删除文件夹或文件。
当您删除文件夹时,IDE 会显示弹出式确认窗口。弹出式窗口会指明要删除的项目数量,包括文件夹和文件夹内的所有文件。
批量删除文件和文件夹
如需批量删除文件夹和文件,请执行以下操作:
选择文件浏览器面板顶部的批量修改图标。
选择要删除的项。所选文件的数量会显示在选择文件标题旁边。
- 要选择或取消选择单个文件,请展开其文件夹并选中文件名旁边的复选框。
- 要选择或取消选择整个文件夹及其内容,请选中相应文件夹名称旁边的复选框。
- 如需选择目录列表的整个部分,请按住 Shift 键并点击。选中范围内顶部项对应的复选框,然后按住 Shift 键,然后选中列表中最后一项对应的复选框。系统会同时选中这两项以及介于两者之间的所有项。您也可以按住 Shift 键点击某个项目,以选择该项目以及目录列表中该项目上方的所有内容。
选择删除商品回收站图标。然后,IDE 会显示一个弹出式菜单,其中列出了所选项。
选择是,删除确认要删除的项,或选择取消返回项选择。
选择选择文件标题中的 X 以退出批量修改模式。
在文件夹项目中移动内容
如需移动文件,请将文件或文件夹拖放到另一个文件夹中。
目标文件夹无需展开即可接收其他文件夹或文件。当您将鼠标悬停在文件夹上时,文件夹会自动展开。
批量移动文件和文件夹
如需批量移动文件夹和文件,请执行以下操作:
选择文件浏览器面板顶部的批量修改图标。
选择要移动的内容。所选文件的数量会显示在选择文件标题旁边。
- 要选择或取消选择单个文件,请展开其文件夹并选中文件名旁边的复选框。
- 要选择或取消选择整个文件夹及其内容,请选中相应文件夹名称旁边的复选框。
- 要选择目录列表的整个部分,请在按住 Shift 键的同时点击。选中范围内顶部项对应的复选框,然后按住 Shift 键,然后选中列表中最后一项对应的复选框。系统会同时选中这两个项目以及这两个项目之间的所有项目。您也可以按住 Shift 键点击某个项目,以选择该项目以及目录列表中该项目上方的所有内容。
点击移动项目文件夹图标以选择选项。然后,IDE 会显示文件夹选择弹出式菜单。
在移至弹出式菜单中,为所选内容选择一个文件夹,或选择新建文件夹以创建新文件夹。项目名称会在下一个菜单页面的顶部显示您选择的文件夹的文件路径。如需将内容移至项目的根目录,请在不选择文件夹的情况下选择 Move。
选择 Move 以确认所选目标,通过选择 New Folder 在所选文件夹中创建新文件夹,或选择文件路径中的项目名称链接以返回主文件夹选项菜单。
在选择文件标题中选择 X,退出批量修改模式。