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视图的子集，这非常有用。
要创建文件夹，请执行以下操作：
- 从相应的菜单中选择创建文件夹选项：
- 如需在目录结构的顶层创建新文件夹，请使用添加文件或文件夹菜单，您可以通过选择文件浏览器面板顶部的 +（加号）图标来访问该菜单。
- 如需在现有文件夹下创建新的子文件夹，请使用现有文件夹的三点状图标 Folder Options（文件夹选项）菜单。
- 为新文件夹输入名称。
- 选择创建。
新文件夹会添加到导航窗格中。
创建文件
当您生成模型时，Looker 会自动创建基于您数据库的模型文件和视图文件。对于现有项目，您可以手动创建新文件。
如需在 LookML 项目中创建新文件，请执行以下操作：
选择相应的菜单：
- 如需在目录结构的顶层创建新文件，请使用添加文件或文件夹菜单，您可以通过选择文件浏览器面板顶部的 +（加号）图标来访问该菜单。
- 如需在现有文件夹下创建新文件，请使用现有文件夹的三点状 Folder Options（文件夹选项）菜单。
选择要创建的 LookML 文件类型。请选择以下列表中的链接，详细了解每种类型的文件。您可以创建以下类型的文件：
在创建文件弹出式窗口中，输入新文件的名称。如需了解文件命名的限制和准则，请参阅有关创建文件和文件夹的重要说明。
选择创建。新文件将显示在您创建它的位置。如有需要，您可以轻松将其移至其他文件夹。
创建视图文件的注意事项
大多数 LookML 开发者都是从一个或多个视图文件开始的，这些文件是在从数据库中一组表生成 LookML 项目时自动创建的。不过，除了本页介绍的创建空白视图文件和上传文件的方法之外，开发模式下的 Looker 开发者还可以通过多种方式将视图文件添加到 LookML 项目中：
根据数据库中的表创建视图文件：
- 在首次连接到数据库时，从数据库表生成视图文件，如生成 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 会显示文件夹选择弹出式菜单。
在移至弹出式菜单中，为所选内容选择一个文件夹，或选择新建文件夹以创建新文件夹。项目名称将在下一个菜单页面顶部显示您所选文件夹的文件路径。如需将项目移至项目的根目录，请在不选择任何文件夹的情况下选择移动。
选择移动确认所选目标位置，选择新建文件夹在所选文件夹中创建新文件夹，或选择文件路径中的项目名称链接返回到主文件夹选项菜单。
选择选择文件标题中的 X 以退出批量修改模式。