Looker-Tableau BI 连接器

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

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 账号，且该账号的用户角色必须包含 explore 权限，才能从 Tableau 访问所需的 LookML 模型。

设置 Tableau Desktop 以连接到 Looker

满足所有要求后，您可以设置 Tableau 桌面版以连接到 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 桌面版连接到 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 Explore。
  9. 如需开始探索数据，请从表格列表中选择一个对象，然后将其拖动到画布上。

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

Tableau 的查询通过开放式 SQL 接口发出。Looker 管理员可以使用 Looker 界面来识别哪些查询源自开放式 SQL 接口，如开放式 SQL 接口文档中所述。

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

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

Looker-Tableau BI 连接器未在 Tableau Exchange 上提供，但您可以按照以下部分中的步骤在 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 账号，且该账号的用户角色必须包含 explore 权限，才能从 Tableau 访问所需的 LookML 模型。

为 Looker-Tableau BI 连接器设置 OAuth

如需将 Looker-Tableau BI 连接器用于 Tableau Server，您需要在 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。
  3. 在搜索结果中，点击注册 OAuth 应用。
  4. 在 Register OAuth App 页面上，点击 Run It 按钮。

  5. 在运行对话框的请求标签页中，在相应字段中输入以下信息：

    • 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 探索器中的 Get OAuth Client App 方法验证是否已成功设置身份验证：

    • 在 API Explorer 的搜索字段中，输入 Get OAuth Client App。
    • 点击运行。
    • 在 client_guid 字段中，输入以下值：tableau-server

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

在 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 安装路径：

Linux 服务器

TACO 文件位置 JAR 文件位置 
/opt/tableau/connectors
 
/opt/tableau/tableau_driver/jdbc

Windows 服务器

TACO 文件位置 JAR 文件位置 
C:\Program Files\Tableau\Connectors
 
C:\Program Files\Tableau\Drivers

在 Tableau Server 上完成设置

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

注意事项

使用 Tableau 桌面设备探索 Looker 数据时，请注意以下事项：

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