Looker 的关联工作表功能可让用户通过熟悉的 Google 表格电子表格界面，以交互方式探索来自 LookML 模型的数据。Google 表格用户可以访问 Looker 支持的 50 多个数据库中的受管数据。“探索”工具非常直观，因为关联工作表呈现了一个井然有序的模型视图，其中包含视图、字段和测量数据，就像它们在 Looker 中的定义一样。通过关联工作表获得的 Looker 数据可用于标准表格结构（例如数据透视表、图表和公式），让您可以通过熟悉的构造灵活地进行分析。
启用“关联工作表”
要使用“关联工作表”，请按以下步骤操作：
- 在 Looker（原始版本）中，Looker 管理员必须在 Looker 管理菜单的平台部分，在 BI 连接器面板中启用 Looker BI 连接器或关联工作表切换开关。在 Looker (Google Cloud Core) 中，这些选项默认处于启用状态。
- 您的 Looker 实例必须由 Looker 托管。
- 如果您的 Looker 实例托管在 Google Cloud 上，则必须运行 Looker 22.20 或更高版本。如果您的 Looker 实例未托管在 Google Cloud 上，则该实例必须运行 Looker 23.4 或更高版本。
- 如果用户希望从 Google 表格连接到您的 Looker 实例，则必须在其 Looker 用户帐号中使用与用于 Google Workspace 帐号相同的电子邮件地址。如果他们的 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 维度和表格汇总方式函数来创建自定义测量。
- 过滤条件等同于 Looker 过滤条件。
数据透视编辑器还会显示属于“探索”的视图列表，您可选择该列表来显示该视图中包含的维度和测量。
选择添加以添加行、列、值或过滤条件。关联工作表会显示“探索”中可用的视图列表。选择视图名称以在视图中显示维度和测量的列表，然后选择为行、列、值或过滤器提供数据的字段。
添加用于构建查询的 Looker 字段和过滤条件后，请选择应用。系统将使用您的 Looker 实例中的数据填充您的工作表。
将 Looker 数据添加到数据透视表后，您可以使用常规的 Google 表格功能来设置数据格式，或根据 Looker 数据构建新的 Google 表格公式。
过滤选项
自最初发布 Looker 的关联工作表功能以来，该平台中增添了新的过滤选项。
按值过滤 - 2023 年 8 月添加
对于 Looker 数据透视表，您可以在关联工作表中过滤 Looker 维度，只需查看值列表并选择和取消选择想要的值即可。以前，在按条件过滤时，您需要手动输入过滤条件值。
要使用此功能，请在数据透视表的过滤器部分添加一个字段，然后点击状态下拉菜单以打开过滤器选项。然后，点击添加过滤条件：
边栏会打开，并且 Google 表格会从 Looker 中提取最常出现的 500 个值。
然后，您可以在项目之间搜索，选择或清除所有项，或者按频率或字母顺序对项进行排序。当您点击底部的确定后，Google 表格就会存储您的选择。然后，您可以点击应用，像平常一样刷新数据透视表应用新的过滤条件。
使用 Looker 过滤条件表达式的过滤条件 - 2023 年 9 月添加
您可以使用 Looker 过滤条件表达式在关联工作表中应用相对日期过滤条件以及许多其他高级过滤条件。例如，您可以在关联工作表中应用“在过去 30 分钟内”或“在过去 10 天内”等过滤条件。
如需使用 Looker 过滤表达式，请执行以下操作：
将字段添加到数据透视表的过滤器部分。
点击状态下拉菜单以显示过滤器选项，然后选择过滤表达式。
在 Value（值）字段中输入任意 Looker 过滤条件表达式。
例如，要过滤过去 7 天的数据，您可以输入“7 天”或“过去 7 天”。
点击 OK（确定）。
除了相对日期过滤之外，现在可以使用的其他过滤示例包括：
- 不以
-FOO%开头的字符串 - 包含且不包含边界的数值范围：
(12, 20]
如需查看所有可用的过滤条件表达式，请参阅 Looker 过滤条件表达式文档页面。
使用 Looker 参数和仅限过滤条件的字段 - 2023 年 10 月添加
仅限过滤条件的字段和参数将显示在 Google 表格中字段选择器的仅限过滤条件的字段部分中，与 Looker 中类似。若要使用它们，请按以下步骤操作：
- 将所选参数和仅限过滤条件的字段添加或拖动到过滤条件部分，就像按维度或测量进行过滤一样。
- 对于包含允许值的参数，这些值将显示在按条件过滤对话框的下拉菜单中。
- 对于仅过滤字段，您可以使用常规的按条件过滤对话框。如果该字段在 Looker 模型中定义了建议，您也可以使用按值过滤功能。
刷新 Google 表格中的数据
数据透视表中的数据是静态的，但可以随时刷新。刷新数据会导致 Looker 查询您的数据库，并使用您的最新数据更新数据透视表。
您的数据透视表和显示“探索”的工作表都会显示最近刷新的时间。
选择刷新以更新数据透视表中的数据。
安排定期刷新时间
要安排自动更新数据，请选择数据透视表中的三点状菜单，然后选择刷新选项；或者，您也可以选择“探索”工作表中的刷新选项。Looker 会显示计划刷新对话框。
修改数据透视表设置
要修改数据透视表中包含的行、列、值或过滤器，请选择三点状菜单旁边的铅笔图标以打开数据透视表编辑器面板。
监控关联工作表
Looker 管理员可以使用系统活动历史记录探索中的 Query API 客户端属性字段组查看关联工作表的使用情况。每次运行新查询时，系统都会在历史记录探索中创建一个条目。
在 Query API 客户端属性字段组中，关联工作表新增了三个字段：
- API 客户端名称 - 此字段将始终显示
Connected Sheets，以标识“关联工作表”条目。 - 关联工作表的电子表格 ID - 该字段显示工作表 ID，包含在该工作表的 Google 表格网址中。
- 关联工作表触发器 - 此字段显示查询是由用户在 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
注意事项
- 数据透视表中显示的数据的大小写区分程度由模型的大小写设置决定。不过，当数据透视表的原生数据不区分大小写的情况下，数据透视表上的过滤器会强制不区分大小写。
- 拥有工作表查看者访问权限的任何人都能在数据透视表中查看缓存的数据。
- 除了对工作表的编辑者权限之外，任何需要修改或刷新数据透视表的用户都需要在 Looker 中拥有正确的权限才能访问数据模型。这包括对数据透视表所依据的模型的访问权限、查看数据的权限，以及通过任何访问权限过滤器或访问权限授予对数据的适当访问权限。
- 如果用户使用 OAuth 向 BigQuery 数据库进行身份验证，则可能需要授予底层数据库权限。
关联工作表的行数和数据限制
使用关联工作表创建的查询上限为 30,000 行。如果查询结果包含更多行，Google 表格就会向用户显示错误消息。如果用户没有 download_without_limit 权限，则无论 Google 表格的限制为何，结果都会被截断为最多 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 地址不在许可名单中的错误。