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 保护了您的 PC 。如果您看到此对话框,请点击更多信息 链接,然后点击仍要运行 按钮。

首次在 Windows PC 上安装 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 权限的用户最多可以输入 100,000 行和 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 探索界面更新查询,然后选择在探索中打开 探索选项以下载新的 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++ 可再发行组件包 (MSVC)

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

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

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