Looker 项目包含一个或多个模型文件、一个或多个查看文件,可能还包括以下类型的文件:
了解模型和视图文件文档页面提供了对模型和视图文件的深入说明。下文将介绍其他文件类型。
如需了解如何访问项目的文件,请参阅访问和修改项目信息文档页面。
项目文件由 Looker 开发者使用 IDE 中的文件夹整理。
信息中心文件
Looker 支持两种类型的信息中心:
- 用户定义的信息中心:可由非开发者用户在未使用 LookML 的情况下创建的信息中心。有关详情,请参阅创建用户定义的信息中心文档页面。
- LookML 信息中心:存储为与项目关联的受版本控制的文件。
如果您的项目包含 LookML 信息中心,它们将在 IDE 中的专用信息中心文件中定义。
如需详细了解 LookML 信息中心,请参阅创建 LookML 信息中心文档页面。
文档文件
借助 Looker 文档文件,您可以使用 GitHub 风格的 Markdown 编写有关 Looker 数据模型的文档或其他说明。这有助于用户熟悉贵组织的 Looker 使用体验。
创建文档文件
要向项目添加文档文件,请执行以下操作:
- 通过创建文档选项使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面中的相应步骤创建文件)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
创建文件后,您可以点击右上角的修改以进行修改。然后,您可以点击预览预览您的更改,或者点击保存以保存您所做的更改。
在 IDE 外部查看文档
要在 Android Studio 之外查看文档(您需要执行下列操作,才能利用下文所述的导航功能),请从左上角的下拉菜单中选择查看文档选项:
您可以将结果页的网址分发给其他用户,这样他们就无需浏览 Looker 的开发者部分即可访问该网址。
在文档中添加导航结构
您可以向文档文件添加边栏,以便用户轻松地查看信息的结构,并在不同文档之间导航:
要为文档添加边栏导航,请从文档的第一行开始创建导航部分。使用三个短划线 (---
) 标记导航部分的开始和结束。
您可以在导航部分使用以下参数:
navigation
您至少要对文档使用 navigation: true
,才能将导航边栏添加到该文档。它在 Markdown 文件中的显示效果如下:
这会向文档添加一个导航边栏,其中包含所有项目文档页面的链接。如果您在文档中仅包含 navigation: true
,则该文档的边栏按文件名的字母顺序列出所有项目文档页面。
另外,您可能会发现按字母顺序整理文件名并不理想,或者您可能不想在页面导航栏中显示某些文档:
如果您想更改文档导航边栏中文件的顺序,或者只想在边栏中显示部分文档,可以使用以下格式:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
因此,现在该网页将仅按您希望的顺序显示文件,具体顺序如下:
title
默认情况下,边栏会显示文档的标题(如果文档以标题开头),如果文件中没有标题,则显示文档的文件名。您可以在文档顶部添加 title
参数,以更改文档在导航边栏中的显示方式:
---
title: New Title for Users
---
除非您在文档的导航部分指定不同的 label
,否则此标题将用作所有文档的导航边栏中的链接文字。
label
如果您想更改页面在文档的导航边栏中的显示方式,可以使用 document
和 label
参数,如下所示:
---
navigation:
- document_one
- document: document_two
label: Customized Label for Document Two
- document_three
- document_four
---
如需使用
label
参数,您必须在文档文件名前添加document:
,如上例所示。如果您不想为文档使用label
,请不要在文件名前添加document:
。
label
值定义了文档在边栏的导航方式,即使该文档引用的文档有自己的 title
参数也是如此。
上面的示例在文档的边栏中如下所示:
section
如果您要将导航边栏拆分为多个部分,则可以使用 section
参数,如下所示:
---
navigation:
- document_one
- document_two
- section: My Section Name
- document_three
- document_four
---
section
参数用于向边栏添加分节符和文本标题:
文本标题本身不是链接;它不是指任何文档文件。
数据文件
数据文件是扩展名为 .json
、.topojson
或 .geojson
的 JSON 文件。
借助 map_layer 参数,您可以将 JSON 文件用作自定义地图,然后利用地图绘制 Looker 中的数据:
然后,您可以将 map_layer_name 参数与维度搭配使用,以便将数据值(例如“巴黎”)与自定义地图上的地理区域关联起来。
您可以在 LookML IDE 中修改 JSON 文件,然后点击保存。对于调试,您可以选择 View Raw,以原始格式查看文件。如果您有合适的扩展程序在浏览器中查看 JSON,您还可以选择以解析格式查看文件:
添加数据文件
如需向您的项目添加 JSON 文件,请使用拖放功能从您的计算机上传文件(有关具体操作,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
项目清单文件
您的项目可能包含项目清单文件,用于以下任务:
每个项目只能有一个清单文件,该文件必须命名为 manifest.lkml
并位于项目目录结构的根级目录和 Git 代码库中。
创建清单文件
如需向项目中添加项目清单文件,请使用 Looker IDE 文件浏览器顶部的 + 菜单中的 Create Project Manifest 选项(有关具体操作,请参阅在 IDE 中使用文件夹文档页面中的创建文件部分)。这将在项目的根目录下创建 manifest.lkml
文件。请勿移动清单文件;该文件需存储在目录结构的根级。
创建项目清单选项只能通过 Looker IDE 中文件浏览器顶部的 + 图标获得。它不是文件夹菜单中的选项,因为清单文件必须位于项目的根目录结构中。
此外,只有在您的项目还没有清单文件的情况下,才可以使用创建项目清单选项,因为项目只能有一个清单文件。
清单锁定文件
向项目清单文件添加远程依赖项时,系统会自动创建清单锁定文件。Looker 使用清单锁定文件跟踪清单文件中指定的远程项目版本:
Looker 开发者无需创建或修改清单锁定文件,因为锁定文件由 Looker 自动管理。
如需了解详情,请参阅从其他项目导入文件文档页面。
语言区域字符串文件
如果您要本地化数据模型,则需要为每个要本地化的语言区域创建语言区域字符串文件,包括您的默认语言区域(例如,通常是美国的英语语言区域)。
语言区域字符串文件列出了要在模型中本地化的每个标签和说明的键值对。每个语言区域的字符串文件都应为每个语言区域或标签提供该语言区域的翻译。如需详细了解如何创建语言区域字符串文件,请参阅本地化 LookML 模型文档页面。
创建语言区域字符串文件
如果您要创建语言区域字符串文件以本地化模型,并且还想使用 Looker 的原生界面本地化功能,则必须使用位于用户文档页面的“语言区域”部分的特定语言区域代码为字符串文件命名。
如需在项目中创建语言区域字符串文件,请执行以下操作:
- 通过创建语言区域字符串文件选项,使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面中的相应步骤创建文件)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
浏览文件
探索通常在模型文件中定义。不过,有时您需要为派生表格创建单独的探索文件,或者需要扩展或优化跨模型探索。
探索文件的文件扩展名为 .explore.lkml
。
创建探索文件
如需在项目中创建探索文件,请执行以下操作:
- 使用 Create Generic LookML File 选项使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面上的创建文件部分)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
创建“探索”文件时:
- 请务必使用文件扩展名
.explore.lkml
- 在项目中创建文件后,请务必使用
include
参数,以便在项目中的其他文件中引用新文件。探索文件可包含在视图、模型和其他“探索”文件中。 - 创建探索文件后,您可以使用 Looker IDE 中的对象浏览器查看对象并转到探索文件。
数据测试文件
您的项目可能有用于验证 LookML 模型的逻辑的数据测试文件。数据测试可以包含在模型文件或视图文件中,但如果您的开发者想要在多个不同的模型中使用相同的数据测试,那么将数据测试保存在单独的专用文件中可能会很有帮助。
创建数据测试文件
如需在项目中创建数据测试文件,请执行以下操作:
- 使用 Create Generic LookML File 选项使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面上的创建文件部分)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
创建数据测试文件时:
优化文件
您的项目可能包含用于 LookML 优化的文件。LookML 优化可以包含在模型、视图或探索文件中,也可以位于它们自己的专属文件中。
创建优化文件
如需在项目中创建优化文件,请执行以下操作:
- 使用 Create Generic LookML File 选项使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面上的创建文件部分)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
创建优化文件时:
- 优化文件的文件扩展名为
.lkml
。 - 在项目中创建优化标签后,请务必使用
include
参数,以便让新文件可供项目中的其他文件引用。
其他文件
许多 LookML 元素可以存储在项目中的不同文件中,也可以放在它们自己的专属文件中。例如,数据测试可以包含在模型文件、视图文件或自己的专用 .lkml
文件中。
创建通用 LookML 文件
如需在项目中创建通用 LookML 文件,请执行以下操作:
- 使用 Create Generic LookML File 选项使用 Looker IDE 创建文件(请参阅在 IDE 中使用文件夹文档页面上的创建文件部分)。
- 使用拖放功能从您的计算机上传文件(有关过程说明,请参阅在 IDE 中使用文件夹文档页面中的上传文件部分)。
文件创建完毕后,请务必使用 include
参数,以便在项目的其他文件中引用新文件。