Looker - Tableau BI 连接器

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

注意： 如果您加入了“Looker–Tableau BI 连接器非公开预览版”计划，请参阅从 Looker - Tableau BI 连接器公开预览版升级部分。

准备工作

您的 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 Connector 的用户都必须拥有一个 Looker 账号，且该账号的用户角色包含对他们要从 Tableau 访问的 LookML 模型的 explore 权限。

设置 Tableau Desktop 以连接到 Looker

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

注意：此过程假定您的计算机上已安装 Tableau Desktop。

每个想要访问 Looker-Tableau BI 连接器的用户都必须下载 avatica-<release_number>-looker.jar 文件和打包的 Tableau 连接器 (TACO) 文件，然后将这些文件保存在计算机上的特定目录中。以下部分介绍了如何下载这些文件以及将其放在计算机上的什么位置：

• 下载并保存 Tableau Connector (TACO) 文件
• 下载并保存 JDBC 驱动程序 (looker.jar) 文件

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
     

     注意：如果您的设置未使用 My Tableau Repository 目录的默认位置，您可以通过在计算机上的 Tableau Desktop 应用中依次选择文件 > 代码库位置来获取实际位置。

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

     注意：对于 macOS，如果 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 实例网址：输入包含 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_interface”。

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

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

• 为 Looker-Tableau BI 连接器设置 OAuth
• 在 Tableau Server 上安装 Looker - Tableau BI 连接器
• 在 Tableau Server 上完成设置

准备工作

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

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

此外，每个使用 Looker–Tableau BI Connector 的用户都必须拥有一个 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 客户端应用）。
   • 点击 Run It。
   • 在 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 服务器	C:\Program Files\Tableau\Connectors	C:\Program Files\Tableau\Drivers

在 Tableau Server 上完成设置

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

• 注册您在为 Looker-Tableau BI 连接器设置 OAuth 时指定的 OAuth 客户端 ID 和 OAuth 实例网址（重定向网址）。如需查看使用类似连接器的示例，请参阅 Tableau 的文档。
• 验证并更新已保存的凭据。如需查看使用类似连接器的示例，请参阅 Tableau 文档。

需要考虑的事项

使用 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 驱动程序 (looker.jar) 文件

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

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

注意 ：从 Looker 实例中移除非公开预览版的 Tableau OAuth 应用后，您的用户需要最新版本的 Tableau 连接器文件，才能使用 Tableau Desktop 连接到 Looker 中的数据。

移除 Tableau OAuth 应用（可选）

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

注意：从 Looker 实例中移除 Tableau OAuth 应用的私享预览版后，用户需要使用最新版本的 Tableau 连接器文件，才能使用 Tableau Desktop 连接到 Looker 中的数据。

1. 打开 Looker API Explorer（如需了解详情，请参阅使用 API Explorer 页面）。
2. 在 API Explorer 的搜索字段中，输入 Delete OAuth Client App（删除 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 客户端应用。
   • 点击运行。
   • 在 client_guid 字段中，输入 Tableau OAuth 应用的值：35FBB268-0CB0-4822-AFE3-28638C1C6269

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