借助自助式探索 功能,Looker 用户可以将 CSV、XLS 和 XLSX 文件上传到 Looker,然后在 Looker 探索中查询和直观呈现数据,而无需配置 LookML 模型或设置 Git 版本控制。
Looker 管理员可以从 Looker 管理员 菜单中选择自助式探索 选项,以配置自助式探索 功能并查看实例上的数据上传。
准备工作
如需使用自助式探索,您的 Looker 实例必须满足以下要求:
- 运行 Looker 25.20 或更高版本(适用于 BigQuery 连接)或 Looker 26.8 或更高版本(适用于 Snowflake 连接)。
- 与 BigQuery 或 Snowflake 数据库建立连接,并且必须以以下方式配置连接:
- 必须使用所有项目 范围配置连接。如需验证连接的范围,请参阅 Looker 管理员菜单中连接页面的数据库标签页中的范围列。连接创建后,连接的项目范围 值便无法修改。
- 必须为永久性派生表 (PDT) 启用连接。如需验证是否已为连接启用 PDT,请打开 Looker 连接 页面,点击连接的修改 按钮,点击以打开可选设置 标签页,然后验证启用 PDT 切换开关是否已开启。
- 对于 Snowflake 连接,数据库管理员必须向 Looker 角色授予
CREATE STAGE。如需了解详情,请参阅创建与 Snowflake 的 Looker 连接的文档页面。
- 对于将创建自助式探索的任何用户,其 Looker 用户账号必须具有
upload_data权限,该权限允许用户将 CSV 文件上传到您的实例。
请注意,从 Google 表格上传数据存在以下限制:
- 使用 Private Service Connect 的 Looker (Google Cloud Core) 实例不支持 Google 表格上传的 OAuth 流程。这些实例必须使用手动网址流程从 Google 表格上传数据。
- 使用 VPC Service Controls 的 Looker (Google Cloud Core) 实例 不支持 Google 表格上传。
启用自助式探索
在用户创建自助式探索之前,Looker 管理员必须执行以下步骤来配置该功能:
- 从 Looker 管理员 菜单的常规 部分中,选择自助式探索 管理页面。
- 在自助式探索 管理页面上,从默认连接 下拉菜单中,选择用于存储自助式探索数据的 BigQuery 或 Snowflake 连接。Looker 会将数据保存到此数据库,以供实例上的自助式探索使用。
- 点击数据上传 切换开关旁边的测试 按钮,以验证默认连接是否有效,以及是否已为永久性派生表 (PDT) 启用连接(如需了解连接要求,请参阅准备工作部分)。如果测试失败,您将无法启用数据上传。请前往连接 管理页面,排查连接问题。
- 如果测试通过,请开启数据上传 切换开关以启用自助式探索功能。
- 如果您希望 Looker 实例支持从 Google 表格上传数据,请执行以下操作:
- 验证您是否已为自助式探索配置 BigQuery 连接(只有 BigQuery 连接支持 Google 表格上传)。
- 使用 Google Cloud 控制台启用支持 Google 表格上传所需的 API。
- 您可以选择为 Google 表格上传启用 OAuth,以便用户可以使用 Google 云端硬盘导航来选择 Google 表格文件以进行数据上传。
- 点击Google 表格数据导入 切换开关旁边的测试 按钮,以运行专门针对 Google 表格上传的测试。
- 开启Google 表格数据导入 切换开关。(必须同时启用数据上传 切换开关和Google 表格数据导入 切换开关,才能从 Google 表格上传数据。)
启用 API 以支持 Google 表格上传
如需让 Looker 支持为 BigQuery 连接从 Google 表格上传数据,IAM 用户必须在 Google Cloud 控制台中启用以下 API,且该用户具有 IAM roles/serviceusage.serviceUsageAdmin 权限:
必须在包含 BigQuery 连接的 Google Cloud 项目中启用此 API,该连接在 自助式探索 管理页面的 默认连接 下拉菜单中指定:
- BigQuery API:所有 BigQuery 操作都需要此 API
必须在与用于上传数据的服务帐号关联的 Google Cloud 项目中启用这些 API(用于 BigQuery 连接上的 PDT 流程的服务帐号,该账号可能与 Google Cloud **默认连接** 下拉菜单的 **自助式探索** 管理页面中指定的项目相同,也可能不同):
- BigQuery API:所有 BigQuery 操作都需要此 API
- Google Sheets API:检索 Google 表格文档中每个工作表的名称时需要此 API
- Google 云端硬盘 API:BigQuery 从云端硬盘读取文件时需要此 API
请按照以下步骤启用 API:
在 Google Cloud 控制台的打开项目选择器中,选择包含 BigQuery 连接的项目,该连接在默认连接下拉菜单的自助式探索管理页面中指定。
在 Google Cloud 控制台的导航菜单中,依次前往 API 和服务 > 库 ,然后打开 BigQuery API。
在 BigQuery API 页面上,如果该 API 尚未启用,请点击启用 。
仍在 BigQuery API 页面上,在 Google Cloud 控制台的打开项目选择器中,选择与用于上传数据的服务帐号关联的 Google Cloud 项目(用于 BigQuery 连接上的PDT 流程的服务帐号)。
在 BigQuery API 页面上,如果该 API 尚未启用,请点击启用 。
在 Google Cloud 控制台的导航菜单中,依次前往 API 和服务 > 库 ,然后打开 Google Sheets API。
在 Google Sheets API 页面上,如果该 API 尚未启用,请点击启用 。
在 Google Cloud 控制台导航菜单中,依次前往 API 和服务 > 库 ,然后打开 Google Drive API。
在 Google Drive API 页面上,如果该 API 尚未启用,请点击启用。
Private Service Connect 实例的配置
如果您的 Looker (Google Cloud Core) 实例使用 Private Service Connect (PSC),则必须执行额外的步骤才能支持 Google 表格上传。
如需允许 Looker 访问 Google 表格 API,您必须使用 Private Service Connect 将 Google 表格发布为服务,然后将 Google 表格添加到 Looker (Google Cloud Core) 配置中的本地 FQDN 设置。配置本地 FQDN 时,请在本地 FQDN 字段中使用 sheets.googleapis.com,并在目标服务连接 URI 字段中使用已发布服务的服务连接 URI。如需了解相关说明,请参阅使用本地 FQDN 连接到已发布服务的文档。
为 Google 表格上传启用 OAuth
在启用 自助式探索、启用 API 以支持 Google 表格上传并启用 Google 表格数据导入 切换开关后,您还可以让用户使用 Google 云端硬盘导航来选择 Google 表格文档以进行数据上传。
如需在 Looker 实例上启用 Google 云端硬盘导航,具有所需角色的 IAM 用户必须在 Google Cloud 控制台中创建 OAuth 客户端,然后将 OAuth 凭据输入到 Looker 实例上的自助式探索管理页面中,如本部分中的过程所述。
如需创建 OAuth 客户端并在 Looker 实例中输入凭据,请按以下步骤操作:
在 Google Cloud 控制台中,使用 Google Cloud 控制台打开项目选择器选择与用于上传数据的服务帐号关联的 Google Cloud 项目(用于 BigQuery 连接上的PDT 流程的服务帐号)。
使用 Google Cloud 控制台主菜单,依次前往 API 和服务 > 凭据。
在凭据 页面中,点击创建凭据 下拉菜单,然后选择 OAuth 客户端 ID 。
在应用类型 下拉菜单中,选择 Web 应用 。
在名称 字段中,输入 OAuth 客户端的名称,例如
Looker upload data from Sheets。在已获授权的 JavaScript 来源 部分中,点击添加 URI 按钮。输入 Looker 实例网址:
https://LOOKER_INSTANCE_URL点击创建 。
点击创建 后,系统会显示已创建 OAuth 客户端 窗口。此窗口会显示 Google Cloud 控制台为 OAuth 客户端创建的客户端 ID 和客户端密钥。请复制并记下这些值。
在 Looker 实例中,从管理员 面板的常规 部分中选择自助式探索 。
在自助式探索 页面上的客户端 ID 和客户端密钥 字段中,粘贴您在 Google Cloud 控制台中创建 OAuth 客户端时从 Google Cloud 控制台复制的值。
点击保存 。
点击 Google 表格数据导入 切换开关旁边的测试 按钮,以测试 OAuth 配置以及 Google 表格上传配置。(您还可以点击数据上传 切换开关旁边的测试 按钮,以验证连接以及 Google 表格配置。)
现在,当用户使用从云端导入 选项上传数据时,Looker 会显示 Google 云端硬盘导航,以便用户选择 Google 表格文档。
查看 Looker 实例上的数据上传
如果您的实例启用了自助式探索,Looker 管理员可以使用自助式探索 管理页面上的数据上传 表格来查看用户在实例上上传的数据。
数据上传 表格会显示实例上数据上传的以下信息:
- 自助式探索的名称,也是打开自助式探索的超链接
- 数据上传的所有者
- 数据上传的日期
- 删除 按钮,允许 Looker 管理员删除文件上传及其关联的自助式探索
Looker 管理员可以使用数据上传 表格中的链接打开实例上的任何自助式探索。不过,Looker 探索 菜单的自助式探索 部分仅列出您拥有的或所有者专门与您共享的自助式探索。探索 菜单不会列出 Looker 管理员实例上的每个自助式探索,因为这可能会使探索 菜单变得笨重。
移除数据上传
数据上传的所有者可以从修改自助式探索页面中移除其上传。此外,Looker 管理员还可以按照以下步骤从自助式探索 管理页面中移除数据上传:
- 从 Looker 管理员 菜单的常规 部分中,选择自助式探索 管理页面。
- 在数据上传 表格中,点击要移除的数据上传的删除 按钮。
- 点击确认对话框中的删除 。