借助 Looker–Tableau 连接器,您可以使用 Tableau Desktop 连接到 Looker 探索中的数据。Looker–Tableau 连接器基于 Looker Open SQL 接口构建而成,该接口支持使用 JDBC 连接到数据源的应用访问 LookML 模型和探索功能。如需了解详情,请参阅开放式 SQL 接口文档。
本指南适用于 Looker–Tableau 连接器的公开预览版。如需提问或分享反馈,请发送电子邮件至
使用要求
如需使用 Looker–Tableau 连接器,必须使用以下组件:
- 一个 Looker 托管且运行 Looker 23.18 或更高版本的 Looker 实例。
- 使用来自 Google BigQuery 连接的数据的 LookML 项目。(LookML 项目必须具有一个model文件,用于在其
connection
参数中指定 Google BigQuery 连接)。 - Looker 用户角色,该角色对您要从 Tableau 访问的 LookML 模型拥有
explore
权限。
此外,在设置 Looker–Tableau 连接器之前,您还需要完成以下步骤:
- 对于 Looker(原始版本)实例,请在 Looker 实例上启用 SQL 接口实验性实验室功能。
- 对于 Looker (Google Cloud Core) 实例,请填写 Looker SQL 接口非正式版协议意向调查表。Google 团队将为您的实例启用 SQL 接口功能。
设置 Tableau Desktop 以连接到 Looker
如需在公开预览版中使用 Looker-Tableau 连接器,您需要执行以下操作:
- 将 Tableau OAuth 应用添加到您的 Looker 实例:Looker 管理员必须使用 Looker API 在您的 Looker 实例上为 Looker–Tableau 连接器注册 Tableau OAuth 应用。每个 Looker 实例只需注册一次 Tableau OAuth 应用,该应用适用于 Looker 实例上的所有用户。
- 下载并保存 Tableau 连接器文件和 JDBC 驱动程序文件:每位想要访问 Looker-Tableau 连接器的用户都必须下载
avatica-<release_number>-looker.jar
文件和打包的 Tableau 连接器 (.taco
) 文件,然后将文件保存到其计算机上的特定目录中。
下面几部分将详细介绍这些步骤。
将 Tableau OAuth 应用添加到您的 Looker 实例
如需使用 Looker–Tableau 连接器,您必须在 Looker 实例上拥有 Tableau OAuth 应用。如需在 Looker 实例上注册 Tableau OAuth 应用,最简单的方法是使用 Looker API Explorer。
如果您的 Looker 实例已安装 API Explorer,您可以使用以下网址格式访问该实例:
https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/
如果您的 Looker 实例未安装 API Explorer,您可以从 Looker Marketplace 安装它。有关信息,请参阅使用 API Explorer 页面。
按照以下步骤,使用 API Explorer 在 Looker 实例上注册 Tableau OAuth 应用:
- 打开 Looker API Explorer(如需了解详情,请参阅使用 API Explorer 页面)。
- 在 API Explorer 的 Search(搜索)字段中,输入 Register OAuth App(注册 OAuth 应用)。
- 在搜索结果中,点击注册 OAuth 应用。
- 在 Register OAuth App(注册 OAuth 应用)页面上,点击 Run It(运行)按钮。
在 Run It 对话框的 Request 标签页中,在相应字段中输入以下信息:
client_guid:
35FBB268-0CB0-4822-AFE3-28638C1C6269
body:
{ "redirect_uri": "http://localhost:55556/Callback", "display_name": "Tableau Desktop", "description": "Tableau Desktop client for JDBC Server", "enabled": true, "group_id": "" }
选中我了解此 API 端点会更改数据复选框。
点击运行。
您可以使用 API Explorer 中的
Get OAuth Client App
方法验证您是否已成功注册 Tableau OAuth 应用:- 在 API Explorer 的搜索字段中,输入获取 OAuth 客户端应用。
- 点击 Run It。
在 client_guid 字段中,输入 Tableau OAuth 应用的值:
35FBB268-0CB0-4822-AFE3-28638C1C6269
如果您成功注册了 Tableau OAuth 应用,则响应标签页将返回您在注册该应用时输入的值。
此步骤并非必需;不过,如果您日后不再使用 Looker–Tableau 连接器,并且想要移除 Tableau OAuth 应用,请参阅移除 OAuth 应用。
下载并保存连接器文件
如需使用 Looker - Tableau 连接器,每位 Tableau 用户都必须下载以下两个文件:
以下各部分提供了有关下载这些文件的说明以及这些文件在计算机上的放置位置。
Tableau 连接器 (.taco
) 文件
Tableau 连接器文件名为 looker-jdbc-v0.2.0.taco
。每个用户都必须下载 .taco
文件,并按照以下步骤将其保存到自己的计算机:
- 如需下载 Tableau 连接器文件,请点击以下链接:
looker-jdbc-v0.2.0.taco
。 下载完成后,将
looker-jdbc-v0.2.0.taco
文件移至My Tableau Repository
目录的Connectors
子目录中。以下是默认目录路径:- Windows:
C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors
MacOS:
/Users/[user]/Documents/My Tableau Repository/Connectors
- Windows:
JDBC 驱动程序 (looker.jar
) 文件
JDBC 驱动程序称为 avatica-<release_number>-looker.jar
。每位用户都必须按照以下步骤从 GitHub 下载 looker.jar
文件,并将文件保存到自己的计算机:
- 前往 https://github.com/looker-open-source/calcite-avatica/releases。
- 下载最新版本的
avatica-<release_number>-looker.jar
文件。 将
avatica-<release_number>-looker.jar
文件保存到每个用户计算机的以下位置:- Windows:
C:\Program Files\Tableau\Drivers
MacOS:
/Library/JDBC
或~/Library/JDBC
- Windows:
从 Tableau Desktop 连接到 Looker 数据
将 Tableau OAuth 应用添加到 Looker 实例并下载 looker-jdbc-v0.2.0.taco
和 avatica-<release_number>-looker.jar
文件后,您就可以按照以下步骤使用 Tableau Desktop 连接到 Looker 实例中的数据:
- 在 Tableau Desktop 的左侧连接窗格的到服务器部分,选择更多...选项。
- 在搜索框中,输入 Looker JDBC by Google。
- 选择 Looker JDBC by Google 选项。
- 在对话框窗口中,输入以下参数:
- 服务器:输入 Looker 实例网址(不含
https://
)。例如:example.cloud.looker.com
- 端口:
443
- Authentication:
OAuth
- OAuth 实例网址:输入完整的 Looker 实例网址和
https://
。例如:https://example.cloud.looker.com
- 服务器:输入 Looker 实例网址(不含
- 选择登录。 Tableau 将打开一个浏览器窗口,以连接到您的 Looker 实例,并通过 OAuth 对您的账号进行身份验证。
- 如果出现提示,请输入您的 OAuth 凭据。如果您已登录,则会在浏览器窗口中看到一条消息,说明 Tableau 已使用浏览器窗口对 Looker 进行了身份验证,您现在可以关闭浏览器窗口了。
- 您完成 Looker 身份验证后,Tableau 会打开一个数据源页面,其中包含与您的 Looker 实例的连接。
- 使用架构下拉菜单选择一个 Looker model,其中包含您要在 Tableau Desktop 中查看的数据。 Tableau 将使用您选择的 Looker 模型中的 Looker 探索填充表格列表。
- 要开始浏览数据,请从表格列表中选择一个对象并将其拖动到画布。
识别 Looker 界面中的 Looker - Tableau 连接器查询
Tableau 中的查询是通过 Open SQL 接口执行的。Looker 管理员可以使用 Looker 界面确定哪些查询来自开放式 SQL 接口,具体如开放式 SQL 接口文档中所述。
来自 Looker - Tableau 连接器的查询的来源值为“sql_interface”或“Sql Interface”。
注意事项
使用 Tableau Desktop 探索 Looker 数据时,请注意以下事项:
- Looker–Tableau 连接器基于 Looker 开放式 SQL 接口构建而成,具有与开放式 SQL 接口相同的 LookML 限制。如需了解详情,请参阅开放式 SQL 接口文档。
- 每当查询发生更改时(包括使用 Looker–Tableau 连接器添加和移除字段时),Tableau 都会自动查询数据库。您可以在 Tableau 中停用自动更新功能:如需了解详情,请参阅 Tableau 文档。
- 您无法使用 Tableau 联接两个 Looker 探索。如果您想加入探索,请使用 Looker 在 Looker 模型中创建联接。如需了解如何在 Looker 中使用联接,请参阅 Looker 文档页面在 LookML 中使用联接和联接参数。
报告 bug
如需报告 bug,请发送电子邮件至
- 您采取的措施的详细列表
- 预期行为
- 实际行为(如果可能,请附上屏幕截图)
移除 Tableau OAuth 应用(可选)
此步骤为可选步骤。不过,如果您日后不再使用 Looker–Tableau 连接器,并且想要从 Looker 实例中移除 Tableau OAuth 应用,则可以使用 API Explorer 执行此操作,具体步骤如下:
- 打开 Looker API Explorer(如需了解详情,请参阅使用 API Explorer 页面)。
- 在 API Explorer 的搜索字段中,输入删除 OAuth 客户端应用。
- 在搜索结果中,点击删除 OAuth 客户端应用。
- 在删除 OAuth 客户端应用页面上,点击运行按钮。
在 Run It 对话框的 Request 标签页中,输入 Tableau OAuth 应用的 client_guid 值:
35FBB268-0CB0-4822-AFE3-28638C1C6269
选中我了解此 API 端点会更改数据复选框。
您可以使用 API Explorer 中的
Get OAuth Client App
方法验证是否已成功移除 Tableau OAuth 应用:- 在 API Explorer 的搜索字段中,输入获取 OAuth 客户端应用。
- 点击 Run It。
在 client_guid 字段中,输入 Tableau OAuth 应用的值:
35FBB268-0CB0-4822-AFE3-28638C1C6269
如果您成功移除了 Tableau OAuth 应用,响应标签页将返回空的正文值。