管理员设置 - 自助式探索

借助自助式探索功能，Looker 用户可以将 CSV、XLS 和 XLSX 文件上传到 Looker，然后在 Looker 探索中查询和直观呈现数据，而无需配置 LookML 模型或设置 Git 版本控制。

Looker 管理员可以从 Looker 管理菜单中选择自助式探索选项，以配置自助式探索功能并查看实例上的数据上传情况。

准备工作

如需使用自助式探索，您的 Looker 实例必须满足以下要求：

  • 运行 Looker 25.18 或更高版本。
  • 已连接到 BigQuery 数据库（如需了解如何在 Looker 实例上设置 BigQuery 连接，请参阅 Google BigQuery 文档页面），并且连接必须按以下方式配置：
    • 必须将连接配置为具有所有项目范围。如需验证连接的范围，请在 Looker 管理员菜单的连接页面中查看数据库标签页中的范围列。连接创建后，其项目范围值便无法修改。
    • 必须为永久性派生表 (PDT) 启用连接。如需验证是否已在 BigQuery 连接上启用 PDT，请打开 Looker 的连接页面，点击 BigQuery 连接对应的修改按钮，点击打开可选设置标签页，然后验证启用 PDT 开关是否已开启。
  • 对于将要创建自助式探索的任何用户，其 Looker 用户账号必须具有 upload_data 权限，该权限允许用户将 CSV 文件上传到您的实例。

启用自助式探索

在用户可以创建自助式探索之前，Looker 管理员必须执行以下步骤来配置该功能：

  1. 在 Looker 管理菜单的常规部分中，选择自助式探索管理页面。
  2. 在自助式探索管理页面上，从默认 BigQuery 连接下拉菜单中选择要用于存储自助式探索数据的 BigQuery 连接。Looker 会将数据保存到此 BigQuery 数据库，以供您实例中的自助式探索使用。
  3. 点击测试连接按钮，验证 BigQuery 连接是否有效，以及是否已启用 PDT，以便支持数据上传。（如需了解连接要求，以便支持数据上传，请参阅准备工作部分。）如果测试失败，您将无法启用数据上传。您可以前往“连接”管理页面，详细了解连接，并进一步测试连接，看看连接在哪个环节失败。
  4. 点击启用数据上传按钮。
  5. 如果您希望 Looker 实例支持从 Google 表格上传数据，还必须使用 Google Cloud 控制台启用所需的 API。请参阅本页面上的启用 API 以支持 Google 表格上传部分。

启用 API 以支持 Google 表格上传

为了支持从 Google 表格上传数据，具有 IAM roles/serviceusage.serviceUsageAdmin 权限的 IAM 用户必须在 Google Cloud 控制台中启用以下 API：

  • 必须在自助式探索管理页面上的默认 BigQuery 连接下拉菜单中指定的 BigQuery 连接所在的 Google Cloud 项目中启用此 API：

    • BigQuery API：所有 BigQuery 操作都必须使用此 API

  • 必须在与用于上传数据的服务账号（用于 BigQuery 连接上的 PDT 进程的服务账号，该服务账号可能与自助式探索管理页面默认 BigQuery 连接下拉菜单中指定的 Google Cloud 项目相同，也可能不同）关联的 Google Cloud 项目中启用以下 API：

    • BigQuery API：所有 BigQuery 操作都必须使用此 API
    • Google Sheets API：用于检索 Google 表格文档中每个工作表的名称
    • Google Drive API：BigQuery 从云端硬盘读取文件时需要此 API

请执行以下步骤来启用 API：

  1. 在 Google Cloud 控制台中，依次选择打开项目选择器和自助式探索管理页面默认 BigQuery 连接下拉菜单中指定的 BigQuery 连接所在的项目。

  2. 在 Google Cloud 控制台的导航菜单中，依次前往 API 和服务 > 库，然后打开 BigQuery API。

    前往 BigQuery API

  3. 在 BigQuery API 页面上，如果该 API 尚未启用，请点击启用。

  4. 仍在 BigQuery API 页面上，从 Google Cloud 控制台打开项目选择器，选择与用于上传数据的服务账号（用于 BigQuery 连接上的 PDT 进程的服务账号）关联的 Google Cloud 项目。

  5. 在 BigQuery API 页面上，如果该 API 尚未启用，请点击启用。

  6. 在 Google Cloud 控制台的导航菜单中，依次前往 API 和服务 > 库，然后打开 Google Sheets API。

    前往 Google Sheets API

  7. 在 Google Sheets API 页面上，如果该 API 尚未启用，请点击启用。

  8. 在 Google Cloud 控制台的导航菜单中，依次前往 API 和服务 > 库，然后打开 Google Drive API。

    前往 Google Drive API

  9. 在 Google Drive API 页面上，如果该 API 尚未启用，请点击启用。

为 Google 表格上传启用 OAuth

启用自助式探索并启用支持 Google 表格上传的 API 后，您还可以让用户使用 Google 云端硬盘导航来选择 Google 表格文档以进行数据上传。

如需在 Looker 实例中启用 Google 云端硬盘导航功能，拥有所需角色的 IAM 用户必须在 Google Cloud 控制台中创建 OAuth 客户端，然后按照本部分中的步骤说明，在 Looker 实例的自助式探索管理页面中输入 OAuth 凭据。

如需创建 OAuth 客户端并在 Looker 实例中输入凭据，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，使用 Google Cloud 控制台打开项目选择器，选择与用于上传数据的服务账号（用于 BigQuery 连接上的 PDT 进程的服务账号）关联的 Google Cloud 项目。

    前往 Google Cloud 控制台

  2. 使用 Google Cloud 控制台主菜单导航到 API 和服务 > 凭据。

  3. 在凭据页面上，点击创建凭据下拉菜单，然后选择 OAuth 客户端 ID。

  4. 在应用类型下拉菜单中，选择 Web 应用。

  5. 在名称字段中，输入 OAuth 客户端的名称，例如 Looker upload data from Sheets。

  6. 在已获授权的 JavaScript 来源 部分中，点击添加 URI 按钮。输入 Looker 实例网址：

    https://LOOKER_INSTANCE_URL

  7. 点击创建。

  8. 点击创建后，系统会显示 OAuth 客户端已创建窗口。此窗口会显示 Google Cloud 控制台为您的 OAuth 客户端创建的客户端 ID 和客户端密钥。复制并记下这些值。

  9. 在 Looker 实例中，从管理面板的常规部分选择自助式探索。

  10. 在自助式探索页面上，在客户端 ID 和客户端密钥字段中，粘贴您在 Google Cloud 控制台中创建 OAuth 客户端时从 Google Cloud 控制台中复制的值。

  11. 点击保存。

现在，当用户使用从云端导入选项上传数据时，Looker 会显示 Google 云端硬盘导航界面，供用户选择 Google 表格文档。

查看 Looker 实例中的数据上传

如果您的实例已启用自助式探索，Looker 管理员可以使用自助式探索管理页面上的数据上传表来查看用户已在实例上上传的数据。

数据上传表格会显示有关实例上数据上传的以下信息：

  • 自助式探索的名称，也是一个用于打开自助式探索的超链接
  • 数据上传的所有者
  • 数据上传日期
  • 一个删除按钮，供 Looker 管理员删除文件上传及其关联的自助式探索

Looker 管理员可以使用数据上传表中的链接打开实例上的任何自助式探索。不过，Looker 探索菜单的自助探索部分仅列出您拥有的或所有者专门与您共享的自助探索。探索菜单不会列出 Looker 管理员实例中的所有自助探索，因为这可能会使探索菜单变得繁琐。

移除数据上传

数据上传的所有者可以从自行编辑探索页面中移除其上传的数据。此外，Looker 管理员还可以按照以下步骤从自助式探索管理页面中移除数据上传：

  1. 在 Looker 管理菜单的常规部分中，选择自助式探索管理页面。
  2. 在数据上传表格中，点击要移除的数据上传对应的删除按钮。
  3. 点击确认对话框中的删除。