本页面介绍了如何在 Looker 中通过探索操作 齿轮菜单启用和使用关联工作表 快捷链接选项。关联工作表 选项会打开 Google 表格，并启动从 Google 表格到 Looker 探索的连接。然后，您可以使用所选 Looker 探索中的字段，在新建的 Google 表格中构建报告、数据透视表或图表。
准备工作
如需使用关联工作表 快捷链接，您需要具备以下条件：
- Looker 实例，管理员已按照本页面的启用和配置“关联工作表”快捷链接部分中的说明为此实例启用和配置了该功能
- Looker 用户账号，该账号对您要连接到表格的 LookML 模型具有
explore权限 - Google 账号，该账号的电子邮件地址与您的 Looker 账号关联的电子邮件地址相同
通过探索使用“关联工作表”快捷链接
如果您的 Looker 管理员已启用此功能，您可以启动 Google 表格与您有权访问的任何探索之间的连接：
使用与您的 Google 账号关联的电子邮件地址登录 Looker。
在 Looker 中，找到您要用作数据源的探索。
点击 探索操作 齿轮图标，然后选择 关联工作表。
首次使用此功能时，系统会提示您授权 Looker 访问您的 Google 账号。选择您要使用的 Google 账号。Google 账号的电子邮件地址必须与您的 Looker 用户账号关联的电子邮件地址一致。
查看权限请求页面上请求的权限，然后点击允许 。
系统会在 Google 表格中打开一个新的浏览器标签页，并显示一个对话框，询问您是否要将 Google 账号与 Looker 账号相关联。点击关联账号 。
Google 表格现在已连接到您启动时所用的 Looker 探索。在 Google 表格中，您可以添加探索中的字段、创建数据透视表、构建图表以及应用公式来分析 Looker 探索中的数据。
如需详细了解如何在关联工作表中构建查询，请参阅将关联工作表用于 Looker文档页面。
启用和配置“关联工作表”快捷链接
如需在探索操作 齿轮菜单中启用关联工作表 快捷链接，您的 Looker 实例必须满足以下要求：
- 您的实例必须运行 Looker 25.20 或更高版本。
- 对于 Looker (Google Cloud Core) 实例，关联工作表 快捷链接仅支持 公共安全连接 或 混合连接 网络连接。不支持 Looker (Google Cloud Core) 专用连接（专用服务访问通道）实例。
- 对于 Looker（原始版本）实例，关联工作表 快捷链接仅支持 Looker 托管的实例。客户托管的 Looker 实例不受支持。
如需在 Looker 实例的探索操作 齿轮菜单中启用关联工作表 选项，管理员必须执行以下常规任务，这些任务将在以下部分中介绍：
- 在 Google Cloud 控制台中启用 Google Sheets API。
- 在 Google Cloud 控制台中创建 OAuth 客户端，该客户端位于启用 Google Sheets API 的同一 Google Cloud 控制台项目中。
- 在 Looker BI 连接器页面上启用和配置启用“关联工作表”快捷链接 选项。
在 Google Cloud 控制台中启用 Google Sheets API
关联工作表 快捷链接使用 Google Sheets API，因此必须在您将用于创建 OAuth 客户端的同一项目中启用此 API。拥有 IAM roles/serviceusage.serviceUsageAdmin 权限的 IAM 用户可以启用 Google Sheets API。
请按照以下步骤启用 Google Sheets API：
在 Google Cloud 控制台的导航菜单中，依次前往 API 和服务 > 库 ，然后打开 Google Sheets API。
在 Google Cloud 控制台的打开项目选择器 中，选择您要用于从 Looker 探索连接到 Google 表格的项目。您必须在整个“关联工作表”快捷链接设置过程中使用同一 Google Cloud 控制台项目，以便在您配置 OAuth 的同一项目中启用 Google Sheets API。
在 Google Sheets API 页面上，如果该 API 尚未启用，请点击启用 。
创建 OAuth 客户端
拥有所需角色的 IAM 用户必须创建 OAuth 客户端。
您可以在所需的任何 Google Cloud 项目中设置 OAuth 客户端。不过，必须在此同一项目中启用 Google Sheets API。
如需创建客户端及其凭据，请按以下步骤操作：
在 Google Cloud 控制台中，使用 Google Cloud 控制台的打开项目选择器 打开您在其中启用了 Google Sheets API 的同一项目。
使用 Google Cloud 控制台主菜单，依次前往 API 和服务 > 凭据。
在凭据 页面中，点击创建凭据 下拉菜单，然后选择 OAuth 客户端 ID 。
在应用类型 下拉菜单中，选择 Web 应用 。
在名称 字段中，输入 OAuth 客户端的名称，例如
Looker to Connected Sheets。在已获授权的重定向 URI 部分中，点击添加 URI 按钮。添加以下 URI：
https://LOOKER_INSTANCE_URL/oauth2callback点击添加 URI 按钮，以添加以下 URI：
https://LOOKER_INSTANCE_URL/external_oauth/redirect点击创建 。
点击创建 后，系统会显示已创建 OAuth 客户端 窗口。此窗口会显示 Google Cloud 控制台为您的 OAuth 客户端创建的客户端 ID 和客户端密钥。请复制并记下这些值，因为在配置“启用关联工作表快捷链接”选项时需要用到它们。
配置“启用关联工作表快捷链接”选项
在控制台中启用 Google Sheets API 并 Google Cloud 创建 OAuth 客户端后，您可以通过执行以下步骤在 Looker 实例上启用关联工作表快捷链接： Google Cloud
- 在 Looker 实例中，从管理 面板的平台 部分中选择 BI 连接器 。
- 如果Google 表格 开关尚未启用，请启用它。
- 启用嵌套开关启用“关联工作表”快捷链接 。
- 在 客户端 ID 和 客户端密钥 字段中，粘贴您在 Google Cloud 控制台中创建 OAuth 客户端时从 Google Cloud 控制台复制的值。
- 点击保存 。
现在，您已为 Looker 实例设置探索操作 齿轮菜单中的关联工作表 选项。
从试行计划迁移
如果您的组织参与了早期的 Open in Sheets 功能试行计划，您的 Looker 实例将使用 Looker 提供的集中管理的 OAuth 客户端。此设置将被弃用，取而代之的是更安全、更具可伸缩性的方法，即每个 Looker 管理员为其 Looker 实例配置自己的 OAuth 客户端。现有试行计划客户应过渡到此新配置，以确保功能持续可用。
如需迁移到新版本，管理员必须在 Google Cloud 控制台中设置组织的 OAuth 客户端，然后在 Looker BI 连接器管理页面中配置凭据。这些步骤与首次设置相同，本页面的以下部分介绍了这些步骤：
- 在 Google Cloud 控制台中启用 Google Sheets API
- 在 Google Cloud 控制台中创建 OAuth 客户端，该客户端位于启用 Google Sheets API 的同一 Google Cloud 控制台项目中
- 在 Looker BI 连接器页面上启用和配置启用“关联工作表”快捷链接 选项
管理员完成这些步骤后，您的实例将自动使用新的客户管理的 OAuth 流程。之前的试行计划功能及其对 Looker 管理的 OAuth 客户端的依赖将不再有效。
问题排查
- 电子邮件地址不匹配错误： 如果您在 Google 身份验证步骤中遇到错误，请确保您选择的 Google 账号的电子邮件地址与您的 Looker 用户账号的电子邮件地址完全相同。
- “关联工作表”选项不可见： 只有当您的 Looker 管理员在 BI 连接器设置中启用了此功能时，此选项才会显示在探索操作 齿轮菜单中。请与您的 Looker 管理员联系以获取帮助。
- Google Cloud 控制台权限： 配置 OAuth 客户端和权限请求页面的管理员需要在 Google Cloud 项目中拥有
roles/oauthconfig.editor和roles/serviceusage.serviceUsageAdmin权限。 - 对于公开预览版期间的其他问题或反馈，请发送电子邮件至
looker-connected-sheets-external@google.com。