StarRocks × Tableau 集成指南使用 StarRocks Tableau JDBC Connector 连接 Tableau Desktop 与 Tableau Server【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocksStarRocks Tableau JDBC Connector 是官方为 Tableau 用户提供的定制扩展组件专门解决 Tableau 连接 StarRocks 时存在的协议适配与功能兼容问题。本文以 docs/en/integrations/BI_integrations/Tableau_Desktop.md 为核心骨架完整讲解该 Connector 的安装部署步骤覆盖 Tableau Desktop 与 Tableau Server 两种形态、连接配置、LDAP 认证支持以及服务端 StarRocks 侧的配套认证配置。读完本文你将能够在自己的环境中独立完成 StarRocks 与 Tableau 的端到端打通并理解其底层工作原理。概述Connector 解决了什么问题Tableau 本身自带通用的 ODBC/JDBC 连接能力但通用连接在面对 StarRocks 时存在两大痛点一是需要手工拼接驱动、配置繁琐二是对 Tableau 标准功能如数据源刷新、SQL 方言改写、谓词下推等的支持不完整。StarRocks Tableau JDBC Connector 正是为弥补这一短板而设计的定制扩展组件简化连接流程安装后在 Tableau 的Connect菜单中直接出现StarRocks JDBC by CelerData入口无需手工配置复杂的数据源参数增强功能支持对 Tableau 标准功能提供更完整的适配连接性能与功能完整性均优于默认的通用 ODBC/JDBC 连接方式。从技术原理看该 Connector 基于 JDBC 驱动工作而 StarRocks 对外提供兼容 MySQL 协议的查询端口FE 节点默认query_port为9030见 Hex.md 与 Superset.md因此需要配套 MySQL JDBC Driver 作为底层通信通道Connector 负责将 Tableau 的请求翻译为 StarRocks 可执行的 SQL 方言。主要特性LDAP 支持支持通过密码提示进行 LDAP 登录实现安全认证满足企业级统一身份认证需求高兼容性在 TDVTTableau Design Verification ToolTableau 官方设计验证工具测试中达到99.99%的兼容性仅有一个轻微的失败案例意味着绝大多数 Tableau 功能包括数据提取、实时连接、发布等都能正常工作。前提条件开始安装前请确认环境满足以下要求组件版本要求Tableau Desktop / Tableau ServerTableau 2020.4 及以上版本StarRocksv3.2 及以上版本说明StarRocks v3.2 起对 MySQL 8.0 协议与相关驱动的兼容性更加完善因此 Connector 依赖的 MySQL JDBC Driver 8.0.33 在该版本组合下表现最佳。为 Tableau Desktop 安装 ConnectorTableau Desktop 是个人分析工具安装步骤面向单机整个过程分为放置 JDBC 驱动与放置 Connector 文件两步。下载 MySQL JDBC Driver 8.0.33前往 MySQL 官方归档下载页MySQL Community Downloads 的 C Connector / JDBC 归档区获取mysql-connector-j-8.0.33.jar。存放驱动文件到以下目录目录不存在则手动创建macOS~/Library/Tableau/DriversWindowsC:\Program Files\Tableau\Drivers下载 StarRocks Tableau JDBC Connector 文件从 Tableau Exchange 市场中的 StarRocks JDBC by CelerData 产品页下载 Connector 的.taco文件。存放 Connector 文件到以下目录macOS~/Documents/My Tableau Repository/ConnectorsWindowsC:\Users\[Windows User]\Documents\My Tableau Repository\Connectors启动 Tableau Desktop。导航至Connect→To a Server→StarRocks JDBC by CelerData开始配置连接。为 Tableau Server 安装 ConnectorTableau Server 是集群化部署形态Connector 必须安装到每个节点上安装后还需重启整个 Server 使配置生效。下载 MySQL JDBC Driver 8.0.33来源同上。存放驱动文件到以下目录目录不存在则手动创建Linux/opt/tableau/tableau_driver/jdbcWindowsC:\Program Files\Tableau\Drivers:::info Linux 权限要点 在 Linux 系统中必须为Tableau用户授予访问该目录的权限。请按以下步骤操作创建目录并复制驱动文件到指定目录sudo mkdir -p /opt/tableau/tableau_driver/jdbc # 将 path_to_driver_file_name 替换为驱动文件的绝对路径。 sudo cp /path_to_driver_file_name.jar /opt/tableau/tableau_driver/jdbc为Tableau用户授予文件读取权限# 将 driver_file_name 替换为驱动文件的名称。 sudo chmod 755 /opt/tableau/tableau_driver/jdbc/driver_file_name.jar:::下载 StarRocks Tableau JDBC Connector 文件来源同 Desktop。将 Connector 文件存放至每个节点的以下目录Linux/opt/tableau/connectorsWindowsC:\Program Files\Tableau\Connectors重启 Tableau Servertsm restart:::info 每次添加、删除或更新 Connector 后必须重启 Tableau Server 才能使更改生效。 :::使用说明连接配置与 LDAP 启用完成安装并启动 Tableau 后在Connect → To a Server中选择StarRocks JDBC by CelerData随后填写连接信息配置项填写内容Server / HostStarRocks FE 节点的 IP 或主机名PortFE 节点的查询端口MySQL 协议端口默认9030Username / PasswordStarRocks 中创建的账号与密码LDAP 登录支持如果企业使用 LDAP 统一认证可在配置过程中切换到Advanced选项卡勾选Enable LDAP开关。开启后Tableau 会在登录时弹出密码提示通过 LDAP 服务完成密码校验实现安全认证。服务端配套StarRocks 侧 LDAP 认证配置Connector 的Enable LDAP开关解决的是客户端如何把认证请求交给 LDAP的问题而要让 LDAP 登录真正可用还需要在 StarRocks 服务端完成 LDAP 认证的启用与用户创建。这部分配置与 Connector 配合使用详见 LDAP Authentication。第一步在 FE 节点配置 LDAP 服务。编辑 FE 配置文件conf/fe.conf添加 LDAP 服务地址与端口# LDAP 服务 IP 地址 authentication_ldap_simple_server_host # LDAP 服务端口默认 389 authentication_ldap_simple_server_port # 是否允许与 LDAP 服务器建立非加密连接。默认 true设为 false 表示必须使用 SSL 加密访问 LDAP authentication_ldap_simple_ssl_conn_allow_insecure # 存放 LDAP 服务器 SSL CA 证书的本地路径支持 pem 和 jks 格式 # 若证书由可信机构签发则无需设置 authentication_ldap_simple_ssl_conn_trust_store_path # 访问本地 SSL CA 证书的密码pem 格式证书无需密码仅 jks 格式需要 authentication_ldap_simple_ssl_conn_trust_store_pwd LDAP 认证支持两种绑定模式可按需配置搜索绑定search-and-bind模式由 StarRocks 使用管理员账号在 LDAP 中检索用户再绑定需额外配置# 用户 Base DN指定检索范围 authentication_ldap_simple_bind_base_dn # LDAP 对象中标识用户的属性名默认 uid authentication_ldap_simple_user_search_attr # 用于检索用户的管理员 DN authentication_ldap_simple_bind_root_dn # 检索用户时使用的管理员密码 authentication_ldap_simple_bind_root_pwd 直接绑定direct bind模式跳过检索直接用构造的 DN 绑定适用于 DN 结构可预测的场景# 直接绑定认证的 DN 模式使用 ${USER} 占位用户名多个模式用分号 ; 分隔 authentication_ldap_simple_bind_dn_pattern 示例uid${USER},ouPeople,dcexample,dccom跨多个 OU 时可用uid${USER},ouEngineering,dcexample,dccom;uid${USER},ouMarketing,dcexample,dccom系统按顺序尝试各模式返回第一个绑定成功的。第二步创建使用 LDAP 认证的用户-- 示例 1显式指定 DN CREATE USER tom IDENTIFIED WITH authentication_ldap_simple AS uidtom,oucompany,dcexample,dccom -- 示例 2不指定 DN登录时由系统根据 DN 模式直接绑定或搜索绑定解析 CREATE USER tom IDENTIFIED WITH authentication_ldap_simple完成上述配置后用户在 Tableau 中勾选Enable LDAP并使用 LDAP 账号密码登录即可完成全链路认证。验证与常见排查安装与配置完成后可通过以下方式验证集成是否生效连接验证在 Tableau 中新建数据源输入 FE 地址、端口9030、账号密码点击连接若连接失败首先确认 FE 的query_port是否开放、账号权限是否具备目标库表访问权。LDAP 验证在Advanced选项卡勾选Enable LDAP后尝试使用 LDAP 账号登录若失败检查fe.conf中的authentication_ldap_simple_server_host/port是否可达以及绑定模式配置bind_base_dn/bind_dn_pattern是否正确。Server 集群一致性Tableau Server 场景下确认每个节点的/opt/tableau/connectors与/opt/tableau/tableau_driver/jdbc都已放置对应文件且Tableau用户对驱动文件具备读权限更新 Connector 后务必执行tsm restart。功能验证通过 TDVT 覆盖的常用操作数据提取、实时连接、筛选、聚合、发布到 Server进行冒烟测试确认兼容性表现符合预期。总结StarRocks Tableau JDBC Connector 为 Tableau Desktop 与 Tableau Server 用户提供了开箱即用的 StarRocks 连接方案通过放置 MySQL JDBC Driver 与 Connector 文件完成安装通过StarRocks JDBC by CelerData入口快速建立连接通过Enable LDAP开关对接企业级 LDAP 认证。配合 StarRocks 服务端的 LDAP 认证配置见 LDAP Authentication即可构建一套安全、高兼容、高性能的 BI 分析链路。【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 StarRocks × Tableau 集成指南：使用 StarRocks Tableau JDBC Connector 连接 Tableau Desktop 与 Tableau Server
StarRocks × Tableau 集成指南使用 StarRocks Tableau JDBC Connector 连接 Tableau Desktop 与 Tableau Server【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocksStarRocks Tableau JDBC Connector 是官方为 Tableau 用户提供的定制扩展组件专门解决 Tableau 连接 StarRocks 时存在的协议适配与功能兼容问题。本文以 docs/en/integrations/BI_integrations/Tableau_Desktop.md 为核心骨架完整讲解该 Connector 的安装部署步骤覆盖 Tableau Desktop 与 Tableau Server 两种形态、连接配置、LDAP 认证支持以及服务端 StarRocks 侧的配套认证配置。读完本文你将能够在自己的环境中独立完成 StarRocks 与 Tableau 的端到端打通并理解其底层工作原理。概述Connector 解决了什么问题Tableau 本身自带通用的 ODBC/JDBC 连接能力但通用连接在面对 StarRocks 时存在两大痛点一是需要手工拼接驱动、配置繁琐二是对 Tableau 标准功能如数据源刷新、SQL 方言改写、谓词下推等的支持不完整。StarRocks Tableau JDBC Connector 正是为弥补这一短板而设计的定制扩展组件简化连接流程安装后在 Tableau 的Connect菜单中直接出现StarRocks JDBC by CelerData入口无需手工配置复杂的数据源参数增强功能支持对 Tableau 标准功能提供更完整的适配连接性能与功能完整性均优于默认的通用 ODBC/JDBC 连接方式。从技术原理看该 Connector 基于 JDBC 驱动工作而 StarRocks 对外提供兼容 MySQL 协议的查询端口FE 节点默认query_port为9030见 Hex.md 与 Superset.md因此需要配套 MySQL JDBC Driver 作为底层通信通道Connector 负责将 Tableau 的请求翻译为 StarRocks 可执行的 SQL 方言。主要特性LDAP 支持支持通过密码提示进行 LDAP 登录实现安全认证满足企业级统一身份认证需求高兼容性在 TDVTTableau Design Verification ToolTableau 官方设计验证工具测试中达到99.99%的兼容性仅有一个轻微的失败案例意味着绝大多数 Tableau 功能包括数据提取、实时连接、发布等都能正常工作。前提条件开始安装前请确认环境满足以下要求组件版本要求Tableau Desktop / Tableau ServerTableau 2020.4 及以上版本StarRocksv3.2 及以上版本说明StarRocks v3.2 起对 MySQL 8.0 协议与相关驱动的兼容性更加完善因此 Connector 依赖的 MySQL JDBC Driver 8.0.33 在该版本组合下表现最佳。为 Tableau Desktop 安装 ConnectorTableau Desktop 是个人分析工具安装步骤面向单机整个过程分为放置 JDBC 驱动与放置 Connector 文件两步。下载 MySQL JDBC Driver 8.0.33前往 MySQL 官方归档下载页MySQL Community Downloads 的 C Connector / JDBC 归档区获取mysql-connector-j-8.0.33.jar。存放驱动文件到以下目录目录不存在则手动创建macOS~/Library/Tableau/DriversWindowsC:\Program Files\Tableau\Drivers下载 StarRocks Tableau JDBC Connector 文件从 Tableau Exchange 市场中的 StarRocks JDBC by CelerData 产品页下载 Connector 的.taco文件。存放 Connector 文件到以下目录macOS~/Documents/My Tableau Repository/ConnectorsWindowsC:\Users\[Windows User]\Documents\My Tableau Repository\Connectors启动 Tableau Desktop。导航至Connect→To a Server→StarRocks JDBC by CelerData开始配置连接。为 Tableau Server 安装 ConnectorTableau Server 是集群化部署形态Connector 必须安装到每个节点上安装后还需重启整个 Server 使配置生效。下载 MySQL JDBC Driver 8.0.33来源同上。存放驱动文件到以下目录目录不存在则手动创建Linux/opt/tableau/tableau_driver/jdbcWindowsC:\Program Files\Tableau\Drivers:::info Linux 权限要点 在 Linux 系统中必须为Tableau用户授予访问该目录的权限。请按以下步骤操作创建目录并复制驱动文件到指定目录sudo mkdir -p /opt/tableau/tableau_driver/jdbc # 将 path_to_driver_file_name 替换为驱动文件的绝对路径。 sudo cp /path_to_driver_file_name.jar /opt/tableau/tableau_driver/jdbc为Tableau用户授予文件读取权限# 将 driver_file_name 替换为驱动文件的名称。 sudo chmod 755 /opt/tableau/tableau_driver/jdbc/driver_file_name.jar:::下载 StarRocks Tableau JDBC Connector 文件来源同 Desktop。将 Connector 文件存放至每个节点的以下目录Linux/opt/tableau/connectorsWindowsC:\Program Files\Tableau\Connectors重启 Tableau Servertsm restart:::info 每次添加、删除或更新 Connector 后必须重启 Tableau Server 才能使更改生效。 :::使用说明连接配置与 LDAP 启用完成安装并启动 Tableau 后在Connect → To a Server中选择StarRocks JDBC by CelerData随后填写连接信息配置项填写内容Server / HostStarRocks FE 节点的 IP 或主机名PortFE 节点的查询端口MySQL 协议端口默认9030Username / PasswordStarRocks 中创建的账号与密码LDAP 登录支持如果企业使用 LDAP 统一认证可在配置过程中切换到Advanced选项卡勾选Enable LDAP开关。开启后Tableau 会在登录时弹出密码提示通过 LDAP 服务完成密码校验实现安全认证。服务端配套StarRocks 侧 LDAP 认证配置Connector 的Enable LDAP开关解决的是客户端如何把认证请求交给 LDAP的问题而要让 LDAP 登录真正可用还需要在 StarRocks 服务端完成 LDAP 认证的启用与用户创建。这部分配置与 Connector 配合使用详见 LDAP Authentication。第一步在 FE 节点配置 LDAP 服务。编辑 FE 配置文件conf/fe.conf添加 LDAP 服务地址与端口# LDAP 服务 IP 地址 authentication_ldap_simple_server_host # LDAP 服务端口默认 389 authentication_ldap_simple_server_port # 是否允许与 LDAP 服务器建立非加密连接。默认 true设为 false 表示必须使用 SSL 加密访问 LDAP authentication_ldap_simple_ssl_conn_allow_insecure # 存放 LDAP 服务器 SSL CA 证书的本地路径支持 pem 和 jks 格式 # 若证书由可信机构签发则无需设置 authentication_ldap_simple_ssl_conn_trust_store_path # 访问本地 SSL CA 证书的密码pem 格式证书无需密码仅 jks 格式需要 authentication_ldap_simple_ssl_conn_trust_store_pwd LDAP 认证支持两种绑定模式可按需配置搜索绑定search-and-bind模式由 StarRocks 使用管理员账号在 LDAP 中检索用户再绑定需额外配置# 用户 Base DN指定检索范围 authentication_ldap_simple_bind_base_dn # LDAP 对象中标识用户的属性名默认 uid authentication_ldap_simple_user_search_attr # 用于检索用户的管理员 DN authentication_ldap_simple_bind_root_dn # 检索用户时使用的管理员密码 authentication_ldap_simple_bind_root_pwd 直接绑定direct bind模式跳过检索直接用构造的 DN 绑定适用于 DN 结构可预测的场景# 直接绑定认证的 DN 模式使用 ${USER} 占位用户名多个模式用分号 ; 分隔 authentication_ldap_simple_bind_dn_pattern 示例uid${USER},ouPeople,dcexample,dccom跨多个 OU 时可用uid${USER},ouEngineering,dcexample,dccom;uid${USER},ouMarketing,dcexample,dccom系统按顺序尝试各模式返回第一个绑定成功的。第二步创建使用 LDAP 认证的用户-- 示例 1显式指定 DN CREATE USER tom IDENTIFIED WITH authentication_ldap_simple AS uidtom,oucompany,dcexample,dccom -- 示例 2不指定 DN登录时由系统根据 DN 模式直接绑定或搜索绑定解析 CREATE USER tom IDENTIFIED WITH authentication_ldap_simple完成上述配置后用户在 Tableau 中勾选Enable LDAP并使用 LDAP 账号密码登录即可完成全链路认证。验证与常见排查安装与配置完成后可通过以下方式验证集成是否生效连接验证在 Tableau 中新建数据源输入 FE 地址、端口9030、账号密码点击连接若连接失败首先确认 FE 的query_port是否开放、账号权限是否具备目标库表访问权。LDAP 验证在Advanced选项卡勾选Enable LDAP后尝试使用 LDAP 账号登录若失败检查fe.conf中的authentication_ldap_simple_server_host/port是否可达以及绑定模式配置bind_base_dn/bind_dn_pattern是否正确。Server 集群一致性Tableau Server 场景下确认每个节点的/opt/tableau/connectors与/opt/tableau/tableau_driver/jdbc都已放置对应文件且Tableau用户对驱动文件具备读权限更新 Connector 后务必执行tsm restart。功能验证通过 TDVT 覆盖的常用操作数据提取、实时连接、筛选、聚合、发布到 Server进行冒烟测试确认兼容性表现符合预期。总结StarRocks Tableau JDBC Connector 为 Tableau Desktop 与 Tableau Server 用户提供了开箱即用的 StarRocks 连接方案通过放置 MySQL JDBC Driver 与 Connector 文件完成安装通过StarRocks JDBC by CelerData入口快速建立连接通过Enable LDAP开关对接企业级 LDAP 认证。配合 StarRocks 服务端的 LDAP 认证配置见 LDAP Authentication即可构建一套安全、高兼容、高性能的 BI 分析链路。【免费下载链接】starrocksThe worlds fastest open query engine for sub-second analytics both on and off the data lakehouse. With the flexibility to support nearly any scenario, StarRocks provides best-in-class performance for multi-dimensional analytics, real-time analytics, and ad-hoc queries. A Linux Foundation project.项目地址: https://gitcode.com/GitHub_Trending/st/starrocks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考