Looker - Tableau BI 连接器

借助 Looker–Tableau BI 连接器，您可以使用 Tableau Desktop 连接到 Looker 探索中的数据。Looker–Tableau BI 连接器基于 Looker Open SQL 接口构建而成，该接口支持使用 JDBC 连接到数据源的应用访问 LookML 模型和探索功能。如需了解详情，请参阅开放式 SQL 接口文档。

准备工作

您的 Looker 实例必须满足以下要求才能使用 Looker–Tableau BI 连接器：

  • 运行 Looker 24.14 或更高版本。
  • 已针对 Tableau Desktop BI 连接器启用。Looker 管理员必须在 Looker BI 连接器页面上启用 Tableau Desktop 切换开关。
  • 包含使用 Google BigQuery 连接中数据的 LookML 项目：
    • 您必须对 LookML 项目进行配置，将允许的连接字段设置为仅限这些连接选项，并至少选择一个 Google BigQuery 连接。如需了解如何配置模型以及查看模型允许的连接，请参阅访问和修改项目信息文档页面。
    • LookML 项目必须包含一个在其 connection 参数中指定 BigQuery 连接的模型文件。

此外，每个使用 Looker–Tableau BI 连接器的用户都必须拥有一个 Looker 账号，且该账号的用户角色包含他们想要从 Tableau 访问的 LookML 模型的 explore 权限。

设置 Tableau Desktop 以连接到 Looker

满足所有要求后，您就可以将 Tableau Desktop 设置为连接到 Looker 数据。

每位希望访问 Looker–Tableau BI 连接器的用户都必须下载 avatica-<release_number>-looker.jar 文件和打包的 Tableau 连接器 (.taco) 文件，然后将文件保存到其计算机上的特定目录中。以下各部分提供了有关下载这些文件的说明以及这些文件在计算机上的放置位置：

Tableau 连接器 (.taco) 文件

Tableau 连接器文件名为 looker_v1.0.0.taco。每个用户都必须下载 .taco 文件，并按照以下步骤将其保存到自己的计算机：

  1. 如需下载 Tableau 连接器文件，请点击以下链接：looker_v1.0.0.taco

  2. 下载完成后，将 looker_v1.0.0.taco 文件移至 My Tableau Repository 目录的 Connectors 子目录中。以下是默认目录路径：

    • Windows：

      C:\Users\\Windows user\Documents\My Tableau Repository\Connectors

    • MacOS：

      /Users/Mac user/Documents/My Tableau Repository/Connectors

JDBC 驱动程序 (looker.jar) 文件

JDBC 驱动程序称为 avatica-<release_number>-looker.jar。每位用户都必须按照以下步骤从 GitHub 下载 looker.jar 文件，并将文件保存到自己的计算机：

  1. 前往 https://github.com/looker-open-source/calcite-avatica/releases。
  2. 下载最新版本的 avatica-<release_number>-looker.jar 文件。

  3. 将 avatica-<release_number>-looker.jar 文件保存到每个用户计算机的以下位置：

    • Windows：C:\Program Files\Tableau\Drivers

    • MacOS：/Library/JDBC 或 ~/Library/JDBC

从 Tableau Desktop 连接到 Looker 数据

下载并保存 looker_v1.0.0.taco 和 avatica-<release_number>-looker.jar 文件后，您就可以使用 Tableau Desktop 连接到 Looker 实例中的数据，具体步骤如下：

  1. 在 Tableau Desktop 的左侧连接窗格的到服务器部分，选择更多...选项。
  2. 在搜索框中输入 Looker by Google。
  3. 选择 Looker by Google 选项。
  4. 在对话框窗口中，输入以下参数：
    • 服务器：输入 Looker 实例网址（不含 https://）。例如：example.cloud.looker.com
    • 端口：443
    • Authentication：OAuth
    • OAuth 实例网址：输入完整的 Looker 实例网址和 https://。例如：https://example.cloud.looker.com
  5. 选择登录。 Tableau 将打开一个浏览器窗口，以连接到您的 Looker 实例，并通过 OAuth 对您的账号进行身份验证。
  6. 如果系统提示，请登录 Looker。如果您已登录，则会在浏览器窗口中看到一条消息，说明 Tableau 已使用浏览器窗口对 Looker 进行了身份验证，您现在可以关闭浏览器窗口了。
  7. 您完成 Looker 身份验证后，Tableau 会打开一个数据源页面，其中包含与您的 Looker 实例的连接。
  8. 使用架构下拉菜单选择一个 Looker 模型，其中包含您要在 Tableau Desktop 中查看的数据。 Tableau 将使用您选择的 Looker 模型中的 Looker 探索填充表格列表。
  9. 要开始浏览数据，请从表格列表中选择一个对象并将其拖动到画布。

识别 Looker 界面中的 Tableau BI 连接器查询

Tableau 中的查询是通过 Open SQL 接口执行的。Looker 管理员可以使用 Looker 界面确定哪些查询来自开放式 SQL 接口，具体如开放式 SQL 接口文档中所述。

来自 Looker - Tableau BI 连接器的查询的来源值为“sql_interface”或“Sql_interface”。

需要考虑的事项

使用 Tableau Desktop 探索 Looker 数据时，请注意以下事项：

  • Looker–Tableau BI 连接器基于 Looker 开放式 SQL 接口构建而成，具有与开放式 SQL 接口相同的 LookML 限制和 SQL 限制。如需了解详情，请参阅开放式 SQL 接口文档。
  • 每当查询发生更改时（包括使用 Looker–Tableau BI 连接器添加和移除字段时），Tableau 都会自动查询数据库。您可以在 Tableau 中停用自动更新功能：如需了解详情，请参阅 Tableau 文档。
  • 您无法使用 Tableau 联接两个 Looker 探索。如果您想加入探索，请使用 Looker 在 Looker 模型中创建联接。如需了解如何在 Looker 中使用联接，请参阅 Looker 文档页面在 LookML 中使用联接和联接参数。
  • Looker–Tableau BI 连接器旨在与 Tableau 中的实时连接搭配使用。Tableau 的数据提取模式可提取值为“null”的 Looker 测量因此无法生成准确的结果。如果您想使用提取模式，可以直接在 Tableau 中的 Looker 维度字段中创建汇总字段，而不是使用 Looker 测量。

从 Looker 升级 - Tableau BI 连接器公开预览版

如果您加入了 Looker–Tableau BI 连接器公开预览版计划，则您的现有设置将继续照常运行。不过，我们建议您升级到最新版本的 Looker–Tableau BI 连接器。

如需升级到最新的 Looker - Tableau BI 连接器版本，Looker 管理员必须执行以下任务：

  1. 验证 Looker 实例是否满足要求。
  2. 在 Looker 实例上，在 BI 连接器页面上启用 Tableau Desktop 切换开关。

Looker 管理员在 Looker 实例上启用 Tableau Desktop 切换开关后，您的 Looker 实例用户可以执行以下操作以使用最新的 Looker - Tableau BI 连接器：

用户下载并保存 Tableau Connector 文件和 JDBC 驱动程序文件后，就可以从 Tableau Desktop 连接到 Looker 数据。用户需要在升级后的 Looker-Tableau BI Connector 中对其 Looker 账号进行身份验证。

所有 Looker 实例用户都升级到新的 Looker - Tableau BI 连接器后，您可以按照流程，移除您在公开预览版设置过程中添加到 Looker 实例的 Tableau OAuth 应用。

移除 Tableau OAuth 应用（可选）

此过程不是必需的。但是，当您的所有 Looker 实例用户都升级到 looker_v1.0.0.taco Tableau 连接器文件后，您可以从 Looker 实例中移除非公开预览版的 Tableau OAuth 应用，具体步骤如下：

  1. 打开 Looker API Explorer（如需了解详情，请参阅使用 API Explorer 页面）。
  2. 在 API Explorer 的搜索字段中，输入删除 OAuth 客户端应用。
  3. 在搜索结果中，点击删除 OAuth 客户端应用。
  4. 在删除 OAuth 客户端应用页面上，点击运行按钮。

  5. 在 Run It 对话框的 Request 标签页中，输入 Tableau OAuth 应用的 client_guid 值。对于公开预览版 Looker - Tableau BI 连接器版本 (v0.2.0)，client_guid 值如下：

      35FBB268-0CB0-4822-AFE3-28638C1C6269

  6. 选中我了解此 API 端点会更改数据复选框。

  7. 您可以使用 API Explorer 中的 Get OAuth Client App 方法验证是否已成功移除 Tableau OAuth 应用：

    • 在 API Explorer 的搜索字段中，输入获取 OAuth 客户端应用。
    • 点击 Run It。
    • 在 client_guid 字段中，输入 Tableau OAuth 应用的值：35FBB268-0CB0-4822-AFE3-28638C1C6269

    如果您成功移除了 Tableau OAuth 应用，响应标签页将返回空的正文值。