借助 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 驱动程序,请按照以下步骤操作:
使用以下链接下载适用于 Windows 系统架构(64 位或 32 位)的最新 ODBC 安装程序:
打开 ODBC 安装程序文件,然后按照屏幕上的说明操作。
您可能会看到一个 Windows 对话框,其中显示Windows 保护了您的 PC 。如果您看到此对话框,请点击更多信息 链接,然后点击仍要运行 按钮。
首次在 Windows PC 上安装 ODBC 驱动程序后打开 ODC 文件时,Windows 会提示您创建数据源名称 (DSN),以便您将 ODBC 驱动程序与 Excel 等 ODBC 客户端搭配使用。DSN 是一个已保存的配置,其中包含您的 Looker 实例信息和身份验证凭据。
使用 Looker-Excel 连接器
满足 前提条件 并 在计算机上安装 ODBC 驱动程序 后,您可以按照以下步骤在 Microsoft Excel 中打开 Looker 数据:
- 在 Windows PC 上,在浏览器中打开 Looker 实例。
- 打开探索并运行查询。
- 点击“探索”齿轮菜单,然后选择在 Excel 中打开 选项。
在在 Excel 中打开 对话框中,为要包含的行数和列数 选择以下选项之一:
- 当前结果表:选择此选项可包含探索中当前结果表中的所有行和列。行数受探索的行数上限 值的限制。
- 所有结果:选择此选项可包含查询返回给数据库的所有结果。对于启用了行总计的查询,或者从无法流式传输结果 总计百分比的数据库方言检索数据的查询,或者包含以下类型的指标的查询,通常会停用所有结果选项:占上一个总计或运行总计的百分比。 警告:即使所有结果 选项可用,您在下载所有结果时仍应谨慎。某些查询非常大,包含数千或数百万行,这可能会使大多数电子表格程序甚至 Looker 实例不堪重负。
- 自定义:选择此选项可手动指定要包含在 ODC 文件下载中的行数和列数。
- 拥有
download_without_limit权限的用户最多可以输入 100,000 行和 200 列。 - 拥有
download_with_limit权限的用户最多可以输入 5,000 行和 200 列。 - 对于既没有
download_with_limit权限也没有download_without_limit权限的用户,系统不会显示在 Excel 中打开 选项。
在在 Excel 中打开 对话框中,点击下载 。系统会将 ODC 文件下载到您的计算机。
使用 Microsoft Excel 打开 ODC 文件。
Microsoft Excel 会显示有关数据连接被阻止的安全通知。点击启用 以启用数据连接。
Windows 会显示一个用于配置 Google Looker DSN 的对话框。按照以下步骤配置 DSN:
- 在身份验证类型 下拉菜单中,选择 OAuth 。虽然 OAuth 是首选选项,但您可以根据需要选择基本身份验证 。如果您选择基本身份验证,则需要输入 Looker API 凭据。请参阅本页面的使用基本身份验证进行身份验证部分。
- 点击登录 。系统会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
- 在 DSN 对话框中,点击确定 。
- 如果出现提示,请点击确定 以同意覆盖 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,请按照以下步骤操作:
- 在 Windows PC 的控制面板中,打开 ODBC 数据源 应用(在 Windows 8 之前,此应用称为 ODBC 驱动程序数据源管理员 )。
- 点击添加 按钮。
- 双击 Google Looker ODBC 驱动程序 。
- 在配置 Google Looker DSN 对话框中,填写以下字段:
- 数据源名称*:(可选)输入数据源的名称,以便您日后识别此 DSN。
- 主机:输入 Looker 实例的网址。
- 端口:输入要连接到 Looker 实例的端口。默认值为 443 。
- 在身份验证类型 下拉菜单中,选择 OAuth 。虽然 OAuth 是首选选项,但您可以根据需要选择基本身份验证 。如果您选择基本身份验证,则需要输入 Looker API 凭据。请参阅本页面的使用基本身份验证进行身份验证部分。
- 点击登录 。系统会打开一个网络浏览器,用于对您的 Looker 账号进行身份验证。网络浏览器显示登录成功后,关闭网络浏览器并返回到 DSN 对话框。
- 点击测试 以验证连接。
- 在 DSN 对话框中,点击确定 。
- 如果出现提示,请点击确定 以同意覆盖 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 软件包仍会安装,以支持其他应用。如果您不再需要该软件包,可以手动将其卸载。