Looker-Excel 连接器

借助 Looker-Excel 连接器,您可以将 Looker 探索中的查询导出为 Microsoft Excel 可识别的格式。启用 Looker-Excel 连接器后,Looker 探索会在“探索”齿轮菜单中显示在 Excel 中打开选项。选择此选项后,Looker 会将探索查询导出到 Windows PC 上的 ODC 文件中。如果您已安装 ODBC 驱动程序,则可以在 Microsoft Excel 中打开 ODC 文件。

准备工作

如需使用 Looker-Excel 连接器,您必须具备以下条件:

  • Windows 64 位或 32 位 PC。
  • 满足以下要求的 Looker 实例:
    • 运行 Looker 25.8 或更高版本。
    • 已为 Microsoft Excel BI 连接器启用。Looker 管理员必须在 Looker BI 连接器页面上启用 Microsoft Excel 切换开关。
  • 具有用户角色的 Looker 账号,该角色包含用户希望通过 Looker-Excel 连接器访问的 LookML 模型的 explore 权限。

您还必须按照下一部分中的说明安装 ODBC 驱动程序

安装 ODBC 驱动程序

Looker ODBC 驱动程序是一款软件,必须安装在 Looker-Excel 连接器的每位用户的本地计算机上。借助 ODBC 驱动程序,ODBC 兼容的客户端可以连接到 Looker 实例,就像该实例是 SQL 数据库一样。

如需使用 ODBC 驱动程序,您需要安装 ODBC 管理器程序。Windows 通常预装了一个名为“ODBC 数据源”的程序作为管理工具。

对于预发布版非公开预览版,请按以下步骤安装 ODBC 驱动程序:

  1. Looker ODBC 驱动程序 - 预览版下载适用于您的 Windows 系统架构(64 位或 32 位)的最新 ODBC 安装程序。
  2. 打开 ODBC 安装程序文件,然后按照屏幕上的说明操作。
  3. 您可能会看到一个 Windows 对话框,其中显示Windows 保护了您的电脑。如果您看到此对话框,请点击更多信息链接,然后点击仍要运行按钮。

在 Windows 电脑上安装 ODBC 驱动程序后,您必须创建数据源名称 (DSN),才能将 ODBC 驱动程序与 Excel 等 ODBC 客户端搭配使用。DSN 是一种已保存的配置,其中包含 Looker 实例信息和身份验证凭据。首次打开 ODC 文件时,Windows 会提示您创建 DSN,如下一部分中所述。

使用 Looker-Excel 连接器

满足前提条件并在计算机上安装 ODBC 驱动程序后,您可以按照以下步骤在 Microsoft Excel 中打开 Looker 数据:

  1. 在 Windows PC 上,在浏览器中打开 Looker 实例。
  2. 打开探索并运行查询。
  3. 点击“探索”齿轮菜单,然后选择在 Excel 中打开选项。
  4. 在 Excel 中打开对话框中,点击下载。系统会将一个 ODC 文件下载到您的计算机上。
  5. 在电脑上,使用 Microsoft Excel 打开 ODC 文件。
  6. Microsoft Excel 将显示有关已阻止的数据连接的安全通知。点击启用以启用数据连接。
  7. Windows 将显示一个用于配置 Google Looker DSN 的对话框。通过执行以下步骤来配置 DSN:

    1. 身份验证类型下拉菜单中,选择 OAuth。如果 OAuth 不是一个选项,请选择该字段并输入 OAuth
    2. 点击登入。系统随即会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。当网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
    3. 在 DSN 对话框中,点击登录成功对话框中的确定。DSN 对话框将使用您通过 OAuth 登录获得的令牌填充刷新令牌字段。
    4. 点击 DSN 对话框中的确定
    5. 如果系统提示,请点击确定以同意覆盖 DSN。

Excel 将运行查询并将数据插入新的数据透视表对象中。然后,您就可以在计算和可视化图表中使用这些数据了。按 Excel 功能区中的刷新按钮可重新运行查询。

限制

Looker-Excel 连接器仅在 Windows 上受支持,在 Mac 或 Linux 计算机上不受支持。

Looker-Excel 连接器不支持以下探索查询功能:

如果您想在 Microsoft Excel 中打开探索查询,请先移除表格计算和透视列,然后再从“探索”齿轮菜单中选择在 Excel 中打开

问题排查

以下部分提供了有关问题排查程序和工具的信息:

手动添加 DSN

当您使用 Excel 打开 ODC 文件时,Windows 会提示您创建 DSN。如果您需要手动创建或修改 DSN,可以使用 Windows ODBC 驱动程序数据源管理员。

如需手动创建或修改 DSN,请按以下步骤操作:

  1. 在 Windows PC 的控制面板中,打开 ODBC 驱动程序数据源管理员
  2. 点击添加按钮。
  3. 双击 Google Looker ODBC 驱动程序
  4. 配置 Google Looker DSN 对话框中,填写以下字段:
    • 数据源名称*:为数据源输入一个名称,以便日后识别此 DSN。
    • 主机*:输入 Looker 实例的网址。
    • 端口:输入要连接的 Looker 实例上的端口。默认值为 443
    • 身份验证类型:从下拉菜单中选择 OAuth
  5. 点击登入。系统随即会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。当网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
  6. 在 DSN 对话框中,点击登录成功对话框中的确定。DSN 对话框将使用您通过 OAuth 登录获得的令牌填充刷新令牌字段。
  7. 点击测试以验证连接。
  8. 点击 DSN 对话框中的确定
  9. 如果系统提示,请点击确定以同意覆盖 DSN。

使用基本身份验证进行身份验证

OAuth 是首选的 Looker 身份验证方式。或者,如果您在 DSN 对话框中选择基本身份验证作为身份验证类型,则可以使用 API 密钥客户端 ID客户端密钥进行身份验证。如需了解如何创建 API 密钥,请参阅管理员设置 - 用户文档页面。

安装程序日志

如果您需要访问安装程序日志来排查 Looker-Excel 连接器的问题,可以访问 C:\Users\<username>\AppData\Local\Temp 目录中的安装程序日志。安装程序日志名称采用以下格式:

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

升级 Microsoft Visual C++ Redistributable (MSVC)

如果 Microsoft Visual C++ 可再分发 (MSVC) 软件包版本 14 尚不存在,系统会自动安装该软件包。

如果已安装 MSVC 软件包,Google Looker ODBC 驱动程序安装程序不会升级该软件包。如需使用驱动程序随附的 MSVC 版本,请先卸载现有的 MSVC 软件包,然后再运行安装程序。

卸载驱动程序后,MSVC 软件包仍会保持安装状态,以支持其他应用。如果您不再需要该应用,可以手动将其卸载。