Looker-Tableau BI 连接器

借助 Looker 与 Tableau BI 连接器，您可以在 Tableau 中将 Looker 探索用作数据源。Looker-Tableau BI 连接器基于 Looker Open SQL 接口构建，可让使用 JDBC 连接到数据源的应用访问 LookML 模型和探索。如需了解详情，请参阅 Open SQL Interface 文档。

Looker-Tableau BI 连接器支持 Tableau Desktop 和 Tableau Server，但不支持 Tableau Cloud。

准备工作

您的 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
    • 身份验证：OAuth
    • OAuth 实例网址：输入包含 https:// 的完整 Looker 实例网址。例如：https://example.cloud.looker.com
  5. 选择登录。 Tableau 会打开一个浏览器窗口，以连接到您的 Looker 实例并使用 OAuth 对您的账号进行身份验证。
  6. 如果系统提示，请登录 Looker。如果您已登录，浏览器窗口中会显示一条消息，说明 Tableau 已使用该浏览器窗口对 Looker 进行了身份验证，您现在可以关闭该浏览器窗口。
  7. 在您对 Looker 进行身份验证后，Tableau 会打开一个数据源页面，其中包含与您的 Looker 实例的关联。
  8. 使用架构下拉菜单，选择包含您要在 Tableau Desktop 中查看的数据的 Looker 模型。Tableau 会使用您所选 Looker 模型中的 Looker 探索填充表格列表。
  9. 如需开始探索数据，请从表格列表中选择一个对象，然后将其拖动到画布上。

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

从 Tableau 发出的查询是通过 Open SQL 接口发出的。Looker 管理员可以使用 Looker 界面来确定哪些查询来自 Open SQL 接口，如 Open SQL 接口文档中所述。

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

在 Tableau Server 上使用 Looker-Tableau BI 连接器

Tableau Exchange 上不提供 Looker 与 Tableau 的 BI 连接器，但您可以通过执行以下部分中的相应步骤，在 Tableau Server 上安装 Looker 与 Tableau 的 BI 连接器：

准备工作

您的 Looker 实例必须满足以下要求，才能在 Tableau Server 上使用 Looker-Tableau BI 连接器：

  • 运行 Looker 24.14 或更高版本。
  • 包含使用来自 Google BigQuery 连接的数据的 LookML 项目：
    • 必须将 LookML 项目配置为将允许的连接字段设置为仅这些连接选项，并选择至少一个 Google BigQuery 连接。如需了解如何配置模型以及查看模型的允许连接，请参阅访问和修改项目信息文档页面。
    • LookML 项目必须具有一个模型文件，用于在其 connection 参数中指定 BigQuery 连接。

此外，使用 Looker-Tableau BI 连接器的每位用户都必须拥有一个 Looker 账号，且该账号的用户角色对其希望从 Tableau 访问的 LookML 模型具有 explore 权限。

为 Looker-Tableau BI 连接器设置 OAuth

如需使用适用于 Tableau Server 的 Looker-Tableau BI 连接器，您需要在 Looker 实例上设置 OAuth 集成。

您可以使用 Looker API Explorer 为 Looker-Tableau BI 连接器设置 OAuth 集成：

  • 如果您的 Looker 实例已安装 API Explorer，您可以使用以下网址格式访问它：

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

  • 如果您的 Looker 实例没有 API Explorer，您可以从 Looker Marketplace 安装它。如需了解详情，请参阅使用 API Explorer 页面。

如需使用 API Explorer 在 Looker 实例上设置 OAuth 集成，请按以下步骤操作：

  1. 打开 Looker API Explorer（如需了解详情，请参阅使用 API Explorer 页面）。
  2. 在 API Explorer 的搜索字段中，输入 Register OAuth App（注册 OAuth 应用）。
  3. 在搜索结果中，点击注册 OAuth 应用。
  4. 在 Register OAuth App 页面上，点击 Run It 按钮。

  5. 在 Run It 对话框的 Request 标签页中，在相应字段中输入以下信息：

    • client_guid：
    tableau-server
    • body：
    {
  "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
  "display_name": "Looker-Tableau-Server (manual)",
  "description": "Client for Looker-Tableau Server integration (manually added)",
  "enabled": true,
  "group_id": ""
}

  6. 选中我了解此 API 端点将更改数据对应的复选框。

  7. 点击运行。

  8. 您可以使用 API Explorer 中的 Get OAuth Client App 方法验证是否已成功设置身份验证：

    • 在 API Explorer 的搜索字段中，输入 Get OAuth Client App（获取 OAuth 客户端应用）。
    • 点击运行。
    • 在 client_guid 字段中，输入以下值：tableau-server

    如果您成功设置了 OAuth，Response（响应）标签页将返回您在注册应用时输入的值。

在 Tableau Server 上安装 Looker-Tableau BI 连接器

如需在 Tableau Server 上安装 Looker-Tableau BI 连接器，请执行以下步骤：

  1. 点击以下链接下载 Tableau 连接器文件：looker_v1.0.0.taco
  2. 从 https://github.com/looker-open-source/calcite-avatica/releases 下载最新版本的 avatica-<release_number>-looker.jar 文件。
  3. 在 Tableau Server 主机上安装 TACO 和 JAR 文件。文件的位置取决于服务器的操作系统。默认的 Tableau 安装路径如下表所示：
TACO 文件位置 JAR 文件位置
Linux 服务器 
/opt/tableau/connectors

/opt/tableau/tableau_driver/jdbc
Windows Server 
C:\Program Files\Tableau\Connectors

C:\Program Files\Tableau\Drivers

在 Tableau Server 上完成设置

为 Looker-Tableau BI 连接器设置 OAuth 并安装 Looker-Tableau BI 连接器后，您可以在 Tableau Server 主机上执行以下步骤来完成设置：

需要考虑的事项

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

  • Looker-Tableau BI 连接器基于 Looker 开放式 SQL 接口构建，与开放式 SQL 接口具有相同的 LookML 限制和 SQL 限制。如需了解详情，请参阅 Open SQL Interface 文档。
  • 每当对查询进行更改时，Tableau 都会自动查询数据库，包括使用 Looker-Tableau BI 连接器添加和移除字段时。您可以在 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 连接器文件和 JDBC 驱动程序文件后，即可从 Tableau Desktop 连接到 Looker 数据。用户需要在升级后的 Looker-Tableau BI 连接器中对其 Looker 账号进行身份验证。

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

移除 Tableau OAuth 应用（可选）

此过程并非必需的。不过，在所有 Looker 实例用户都升级到 looker_v1.0.0.taco Tableau 连接器文件后，您可以按照以下步骤从 Looker 实例中移除 Tableau OAuth 应用的“Private Preview”版本：

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

  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 的搜索字段中，输入 Get OAuth Client App（获取 OAuth 客户端应用）。
    • 点击运行。
    • 在 client_guid 字段中，输入 Tableau OAuth 应用的值：35FBB268-0CB0-4822-AFE3-28638C1C6269

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