Looker-Excel 连接器

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

准备工作

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

  • Windows 64 位或 32 位 PC。
  • 满足以下要求的 Looker 实例:
    • 运行 Looker 25.16 或更高版本。
    • 已为 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 数据源的程序作为管理工具。如需了解详情,请参阅 Microsoft 关于 ODBC 数据源管理员的文档

如需安装 ODBC 驱动程序,请按以下步骤操作:

  1. 使用以下链接下载适用于您的 Windows 系统架构(64 位或 32 位)的最新 ODBC 安装程序:

  2. 打开 ODBC 安装程序文件,然后按照屏幕上的说明操作。

  3. 您可能会看到一个 Windows 对话框,其中显示Windows 保护了您的电脑。如果您看到此对话框,请点击更多信息链接,然后点击仍要运行按钮。

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

使用 Looker-Excel 连接器

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

  1. 在 Windows PC 上,在浏览器中打开 Looker 实例。
  2. 打开探索并运行查询。
  3. 点击“探索”齿轮菜单,然后选择在 Excel 中打开选项。
  4. 在 Excel 中打开对话框中,针对要包含的行数和列数选择以下选项之一:

    • 当前结果表:选择此选项可将“探索”中的当前结果表中的所有行和列都纳入导出范围。行数受探索的行数限制值的限制。
    • 所有结果:选择此选项可将查询返回的所有数据库结果都纳入到报告中。对于启用了行总计或从无法流式传输结果的数据库方言中检索数据的查询,所有结果选项通常处于停用状态。占总数的百分比或包含以下类型的指标:占上期的百分比累计总计。警告:即使有所有结果选项,您在下载所有结果时仍应谨慎。有些查询非常大,包含数千甚至数百万行,这可能会使大多数电子表格程序甚至您的 Looker 实例不堪重负。
    • 自定义:选择此选项可手动指定要包含在 ODC 文件下载中的行数和列数。
    • 拥有 download_without_limit 权限的用户可以输入最多 10 万的行数和最多 200 的列数。
    • 拥有 download_with_limit 权限的用户可以输入最多 5,000 行的行大小和最多 200 列的列大小。
    • 对于既没有 download_with_limit 权限也没有 download_without_limit 权限的用户,系统不会显示在 Excel 中打开选项。
  5. 在 Excel 中打开对话框中,点击下载。系统会将一个 ODC 文件下载到您的计算机上。

  6. 使用 Microsoft Excel 打开 ODC 文件。

  7. Microsoft Excel 会显示有关已屏蔽数据连接的安全通知。点击启用以启用数据连接。

  8. Windows 会显示一个用于配置 Google Looker DSN 的对话框。通过执行以下步骤来配置 DSN:

    1. 身份验证类型下拉菜单中,选择 OAuth。虽然 OAuth 是首选选项,但您也可以根据需要选择基本身份验证。如果您选择基本身份验证,则需要输入 Looker API 凭据。请参阅本页中的使用基本身份验证进行身份验证部分。
    2. 点击登入。系统随即会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。当网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
    3. 点击 DSN 对话框中的确定
    4. 如果系统提示,请点击确定以同意覆盖 DSN。

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

如果您想检索最新数据,可以执行以下任一操作:

  • 如需重新运行同一查询以从 Looker 获取最新数据,请点击 Excel 功能区中的刷新按钮。
  • 如需修改查询,请使用 Looker Explore 界面更新查询,然后选择在 Explore 中打开 Explore 选项,下载新的 ODC 文件(换句话说,从本流程的第 1 步重新开始)。默认情况下,Excel 会在新 Excel 工作簿中打开新的 ODC 文件。如果您想将透视表从一个工作簿移到另一个工作簿,可以在 Excel 工作簿之间点击并拖动工作表,也可以将透视表从一个工作簿复制并粘贴到另一个工作簿。

限制

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

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

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

问题排查

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

手动添加 DSN

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

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

  1. 在 Windows PC 的控制面板中,打开 ODBC 数据源应用(在 Windows 8 之前,此应用称为 ODBC 驱动程序数据源管理员)。
  2. 点击添加按钮。
  3. 双击 Google Looker ODBC 驱动程序
  4. 配置 Google Looker DSN 对话框中,填写以下字段:
    • 数据源名称*:(可选)为数据源输入一个名称,以便日后识别此 DSN。
    • 主机:输入 Looker 实例的网址。
    • 端口:输入要连接的 Looker 实例上的端口。默认值为 443
    • 身份验证类型下拉菜单中,选择 OAuth。虽然 OAuth 是首选选项,但您也可以根据需要选择基本身份验证。如果您选择基本身份验证,则需要输入 Looker API 凭据。请参阅本页中的使用基本身份验证进行身份验证部分。
  5. 点击登入。系统随即会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。当网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
  6. 点击测试以验证连接。
  7. 点击 DSN 对话框中的确定
  8. 如果系统提示,请点击确定以同意覆盖 DSN。

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

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

安装程序日志

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

  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 软件包仍会保持安装状态,以支持其他应用。如果您不再需要该应用,可以手动将其卸载。