管理员设置 - 自助式探索

借助自助式探索 功能，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 用户必须在 Google Cloud 控制台中启用以下 API，且该用户具有 IAM roles/serviceusage.serviceUsageAdmin 权限：

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

    • BigQuery API：所有 BigQuery 操作都必需

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

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

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

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

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

    前往 BigQuery API

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

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

  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

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

如需在 Looker 实例上启用 Google 云端硬盘导航，具有所需角色的 IAM 用户必须在 Google Cloud 控制台中创建 OAuth 客户端，然后将 OAuth 凭据输入到 Looker 实例上的自助式探索管理页面中，如本部分中的过程所述。

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

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

    前往 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. 点击确认对话框中的删除 。