借助 Looker 关联工作表功能,用户可以通过熟悉的 Google 表格电子表格界面以交互方式探索 LookML 模型中的数据。Google 表格用户可以访问 Looker 支持的 50 多个数据库中的受治理数据。关联工作表会以直观方式呈现模型视图,其中包含视图、字段和测量指标,与 Looker 中的定义完全相同。通过关联工作表使用 Looker 数据可在标准表格结构(例如数据透视表、图表和公式)中使用,让用户可以通过熟悉的结构灵活地进行分析。
启用关联工作表
要使用关联工作表,请按以下步骤操作:
- 在 Looker(原始版本)中,您的 Looker 管理员必须在 Looker 管理菜单的平台部分中的 BI 连接器面板上启用 Looker BI 连接器或关联工作表切换开关。在 Looker (Google Cloud Core) 中,这些选项默认处于启用状态。
- 您的 Looker 实例必须由 Looker 托管。
- 如果您的 Looker 实例托管在 Google Cloud 上,则您的 Looker 实例必须运行 Looker 22.20 或更高版本。如果您的 Looker 实例未托管在 Google Cloud 上,则实例必须运行 Looker 23.4 或更高版本。
- 对于希望从 Google 表格连接到您的 Looker 实例的每位用户,其 Looker 用户账号中的电子邮件地址必须与其 Google Workspace 账号的电子邮件地址相同。如果 Google Workspace 和 Looker 账号电子邮件地址不同,则当他们尝试从 Google 表格连接到 Looker 时,会收到错误消息。
- 您必须在 Google Workspace 管理员控制台中启用用户对无法单独控制的服务的访问权限。此功能通常默认处于启用状态。有关详情,请参阅管理用户对无法单独控制的服务的访问权限帮助文章。
从 Google 表格连接到 Looker
在 Google 表格的数据菜单中,选择数据连接器,然后选择连接到 Looker。
在连接到 Looker 对话框中,输入 Looker 实例的名称,或选择您最近关联的实例的名称,然后选择继续。
当 Google 表格关联到您的 Looker 实例后,Google 表格会打开一个新表格,其中显示所选探索的结构,包括视图、尺寸、测量值以及 Looker 开发者添加的任何字段说明。
使用 Google 表格构建 Looker 查询
Looker 查询是使用 Google 表格的数据透视表构建的。如需将 Looker 数据添加到工作表,请执行以下操作:
从显示“探索”的工作表中,选择数据透视表。
选择是在新工作表中还是在现有工作表中插入新的数据透视表,然后选择创建。
系统会创建一个新的空数据透视表,并打开数据透视表编辑器窗口。您可以添加行、列、值和过滤条件,以根据 Looker 探索中的维度和测量值构建查询。
数据透视编辑器中的行、列、值和过滤条件相当于 Looker 维度和测量指标,具体方式如下:
- 行相当于 Looker 维度。
- 列相当于 Looker 透视维度。
- 值相当于 Looker 测量。您可以通过选择 Looker 维度和 Google 表格的汇总方式函数来创建自定义测量。
- 过滤条件相当于 Looker 过滤条件。
数据透视编辑器还会显示属于“探索”视图的一系列视图,您可以选择这些视图来显示该视图中包含的尺寸和测量值。
选择添加以添加行、列、值或过滤条件。“关联工作表”会显示您的“探索”中可用的视图列表。选择视图名称以显示该视图中的维度和测量列表,然后选择为行、列、值或过滤条件提供数据的字段。
添加 Looker 字段和过滤条件以构建查询后,选择应用。此操作会使用 Looker 实例中的数据填充您的表格。
将 Looker 数据添加到数据透视表后,您可以使用 Google 表格设置数据格式,或根据 Looker 数据构建新的 Google 表格公式。
过滤选项
自 Looker 关联工作表首次发布以来,我们添加了新的过滤选项。
按值过滤 - 添加时间:2023 年 8 月
您可以在 Looker 数据透视表的关联工作表中过滤 Looker 维度,方法是查看值列表并选择和取消选择感兴趣的值。以前,使用条件过滤时,您需要手动输入过滤条件值。
要使用此功能,请在数据透视表的过滤器部分添加一个字段,然后点击状态下拉菜单以打开过滤器选项。然后,点击添加过滤条件:
系统会打开一个边栏,Google 表格将从 Looker 提取 500 个最常出现的值。
然后,您可以在这些项中进行搜索、选择全选或全部清除、或者按频率或按字母顺序对项进行排序。当您点击底部的确定后,Google 表格就会存储您的选择。然后,您可以点击应用,照常刷新数据透视表,并应用您的新过滤器。
使用 Looker 过滤表达式的过滤器 - 2023 年 9 月添加
您可以使用 Looker 过滤条件表达式,在关联工作表中应用相对日期过滤条件以及许多其他高级过滤条件。例如,您可以应用“在过去 30 分钟内”等过滤条件或“在过去 10 天内”关联工作表。
如需使用 Looker 过滤表达式,请执行以下操作:
在数据透视表的过滤器部分添加一个字段。
点击状态下拉菜单以显示过滤条件选项,然后选择过滤表达式。
在值字段中输入任意 Looker 过滤条件表达式。
例如,要过滤过去 7 天的数据,您可以输入“7 天”或“过去 7 天”。
点击 OK(确定)。
除了相对日期过滤之外,现在可以使用的其他过滤示例包括:
- 不以
-FOO%
开头的字符串 - 包含并不包含的数字范围:
(12, 20]
如需查看所有可用的过滤表达式,请参阅 Looker 过滤表达式文档页面。
使用 Looker 参数和仅限过滤条件的字段 - 2023 年 10 月添加
在 Google 表格中,仅限过滤条件的字段和参数会显示在字段选择器的仅限过滤条件的字段部分,就像在 Looker 中一样。要使用这些功能,请按以下步骤操作:
- 将所选参数和仅限过滤条件的字段添加或拖动到过滤条件部分,就像过滤维度或衡量结果一样。
- 对于具有允许值的参数,这些值将显示在按条件过滤对话框的下拉菜单中。
- 对于仅限过滤条件的字段,您可以使用常规的按条件过滤对话框。如果该字段有在 Looker 模型中定义的建议,您也可以使用按值过滤功能。
刷新 Google 表格中的数据
数据透视表中的数据是静态的,但可以随时刷新。刷新数据后,Looker 会查询您的数据库,并使用最新数据更新您的数据透视表。
您的数据透视表和显示“探索”的工作表均会显示最近刷新的时间。
选择刷新以更新数据透视表中的数据。
安排定期刷新
要安排数据的自动更新,请选择数据透视表中的三点状菜单,然后选择刷新选项,或者选择“探索”表格中的刷新选项。Looker 会显示 Scheduled Refresh 对话框。
修改您的数据透视表设置
要修改数据透视表中包含的行、列、值或过滤器,请选择三点状菜单旁边的铅笔图标以打开数据透视表编辑器面板。
监控关联工作表
Looker 管理员可以使用系统活动历史记录探索中的 Query API 客户端属性字段组查看关联工作表的使用情况。每次运行新查询时,系统都会在历史记录探索中创建一个条目。
在 Query API 客户端属性字段组中,新增了三个“关联工作表”字段:
- API 客户端名称 - 此字段将始终显示
Connected Sheets
,以标识关联工作表条目。 - 关联工作表电子表格 ID - 此字段显示的是工作表 ID,即该工作表的 Google 表格网址中包含的工作表 ID。
- 关联工作表触发器 - 此字段显示查询是由用户在 Google 表格中选择刷新按钮触发的,还是由计划刷新触发的。
以下是系统活动网址的示例,其中显示了关联工作表的使用情况。将 <instance_name.looker.com>
替换为您的实例网址。
https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000
注意事项
- 数据透视表中显示的数据的大小写区分取决于模型的大小写设置。但是,数据透视表上的过滤器在对原生 Google 表格数据不区分大小写的情况下,会强制应用不区分大小写。
- 拥有工作表查看者访问权限的任何人都可以查看数据透视表中的缓存数据。
- 除了拥有工作表的编辑者访问权限之外,需要修改或刷新数据透视表的用户还需要在 Looker 中拥有正确的权限才能访问数据模型。这包括对数据透视表所基于的模型的访问权限、查看数据的权限,以及通过任何访问过滤器或访问权限授权对数据的适当访问权限。
- 如果用户使用 OAuth 向 BigQuery 数据库进行身份验证,他们可能需要获得对底层数据库的权限。
关联工作表的行数和数据上限
使用关联工作表创建的查询不能超过 30,000 行。如果查询结果包含更多行,Google 表格将向用户显示错误。如果用户没有 download_without_limit
权限,则无论表格上限如何,结果都将被截断为不超过 5,000 行。
此外,关联工作表查询存在数据大小限制。如果查询返回过多数据,也会导致错误。
如果您看到上述任一错误,请考虑添加过滤条件,或在查询中使用较少和/或不够精细的维度。
排查关联工作表问题
在尝试从 Google 表格连接到 Looker 时,您可能会遇到一些问题。本部分介绍了这些问题以及解决方法。
错误:连接到您的 Looker 实例时出错。请重试。如果问题仍然存在,请发送反馈。
导致此错误的原因可能有多种:
- 输入的 Looker 实例名称不正确。在这种情况下,请验证您的 Looker 实例名称,然后尝试重新连接。
- Google 表格无法连接到 Looker API。如果您的 Looker 实例未使用默认的 API 主机网址,则可能会发生这种情况。要解决此问题,请将 API 管理控制台中的 API 主机网址字段留空。
错误:Looker 实例未配置为使用此功能。请与您的 Looker 管理员联系,以确保其符合条件。
导致此错误的原因可能有多种:
- 您正尝试连接到新创建的 Looker 实例。新的 Looker 实例最多可能需要 24 小时才能在关联工作表中使用。
- 您正在尝试连接到并非由 Looker 托管的 Looker 实例。关联到由 Looker 托管的其他 Looker 实例。
连接到 Looker 实例后未显示任何模型
这表明您没有查看实例上模型所需的权限。
拥有“查看者”角色的 Looker 用户没有足够的权限在 Google 表格中创建连接,因为他们没有足够的权限来使用 Looker 中的“探索”界面。如果用户想使用 Looker 的关联工作表功能,则需要拥有 explore
权限。管理员、开发者和用户角色包含 explore
权限。Looker 管理员可以向用户授予 explore
权限,这样用户应该就可以查看实例上的模型。
错误:您关联的 Looker 账号电子邮件地址与您的 Google 账号电子邮件地址不同。
这表明您的 Looker 账号电子邮件地址与您的 Google 账号使用的电子邮件地址不一致。确保您登录的 Google 账号的电子邮件地址与您的 Looker 账号一致。或者,Looker 管理员可以使用您当前的 Google 电子邮件地址创建一个新的 Looker 用户账号。
错误:错误请求:未找到启用客户端。
此错误表示关联工作表连接器未启用。Looker 管理员必须在 Looker 管理菜单的平台部分,在 BI 连接器面板上启用 Looker BI 连接器或关联工作表切换开关。
错误:403 Forbidden
如果您的 Looker 实例配置了 IP 许可名单,许可名单可能会阻止 Google 表格连接到 Looker API。如需确定许可名单是否是导致该许可名单的原因,请尝试前往 Looker 实例网址,查看是否收到 IP 地址不在许可名单中的错误。