本页面介绍了如何从 Looker 的探索操作齿轮菜单中启用和使用关联工作表快速链接选项。关联工作表选项会打开 Google 表格，并启动从 Google 表格到 Looker 探索的连接。然后，您可以使用所选 Looker 探索中的字段，在新创建的 Google 表格中构建报告、数据透视表或图表。
准备工作
如需使用关联工作表快速链接，您需要满足以下条件：
- 管理员已启用并配置了该功能的 Looker 实例，如本页面的启用和配置关联工作表快捷链接部分所述
- 一个 Looker 用户账号，该账号对您要连接到 Google 表格的 LookML 模型具有
explore权限 - 与您的 Looker 账号关联的邮箱相同的 Google 账号
通过“探索”使用“关联工作表”快捷链接
如果您的 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 Sheets API 的 Google Cloud 控制台项目中，在 Google Cloud 控制台中创建 OAuth 客户端。
- 在 Looker BI Connectors 页面上启用并配置启用“关联工作表”快捷链接选项。
在 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 Cloud 控制台中启用 Google Sheets API 并在 Google Cloud 控制台中创建 OAuth 客户端后，您可以执行以下步骤，在 Looker 实例上启用关联工作表快速链接：
- 在 Looker 实例中，从管理面板的平台部分选择 BI 连接器。
- 如果 Google 表格切换开关尚未启用，请将其启用（您也可以在管理 OAuth 客户端页面上启用预配置的关联工作表客户端；这两个页面之间的设置是同步的）。
- 启用嵌套切换开关启用“关联工作表”快捷链接。
- 在客户端 ID 和客户端密钥字段中，粘贴您在 Google Cloud 控制台中创建 OAuth 客户端时从 Google Cloud 控制台复制的值。
- 点击保存。
现在，您的 Looker 实例已设置探索操作齿轮菜单中的关联工作表选项。
从试行计划迁移
如果贵组织参与了在 Google 表格中打开功能的早期试用计划，则您的 Looker 实例使用的是 Looker 提供的集中管理型 OAuth 客户端。我们正在弃用此设置，转而采用更安全、更可伸缩的方法，即让每位 Looker 管理员为自己的 Looker 实例配置自己的 OAuth 客户端。现有试用客户应改用此新配置，以确保功能继续正常运行。
如需迁移到新版本，管理员必须在 Google Cloud 控制台中设置贵组织自己的 OAuth 客户端，然后在 Looker BI Connectors 管理页面中配置凭据。这些步骤与首次设置相同，如本页的以下部分所述：
- 在 Google Cloud 控制台中启用 Google Sheets API
- 在 Google Cloud 控制台中创建 OAuth 客户端，该客户端应位于启用了 Google Sheets API 的 Google Cloud 控制台项目中
- 在 Looker BI Connectors 页面上启用并配置启用“关联工作表”快捷链接选项
管理员完成这些步骤后，您的实例将自动使用新的客户管理的 OAuth 流程。之前的试用功能及其对 Looker 管理的 OAuth 客户端的依赖将不再有效。
问题排查
- 电子邮件不匹配错误：如果您在 Google 身份验证步骤中遇到错误，请确保您选择的 Google 账号与您的 Looker 用户账号具有完全相同的电子邮件地址。
- “Connected Sheets”选项未显示：只有当 Looker 管理员在“BI 连接器”设置中启用了该功能时，此选项才会显示在探索操作齿轮菜单中。请与您的 Looker 管理员联系，以获取帮助。
- Google Cloud 控制台权限：配置 OAuth 客户端和权限请求页面的管理员需要在 Google Cloud 项目中拥有
roles/oauthconfig.editor和roles/serviceusage.serviceUsageAdmin权限。 - 如需在公开试用期间报告其他问题或提供反馈，请发送电子邮件至
looker-connected-sheets-external@google.com。