本文介绍如何在Smartbi上安装不同的ByteHouse驱动,并完成连接配置。
前提条件
- 已按照环境准备安装好 Smartbi,并为ByteHouse导入了数据。
- 获取用于连接 ByteHouse 的驱动程序,您可以选择以下其中一项:
- MySQL JDBC Driver (Smartbi 自带)
- ClickHouse JDBC Driver
- ByteHouse JDBC Driver
- ByteHouse HTTP JDBC Driver
配置驱动
- 按需准备以下驱动之一:
- ClickHouse JDBC Driver: 新建 Clickhouse 文件夹,并将对应的JDBC Driver jar 文件拷贝到目录下。
- ByteHouse JDBC Driver: 新建 Bytehouse 文件夹,并将对应的JDBC Driver jar 文件拷贝到目录下。
- ByteHouse HTTP JDBC Driver: 新建 Bytehousehttp 文件夹,并将对应的JDBC Driver jar 文件拷贝到目录下。
- 将需要使用驱动文件夹分别拷贝到以下目录下:
- {Smartbi}/Tomcat/bin/dynamicLibraryPath
- {Smartbi}/smartbiOLAP/dynamicLibraryPath
连接信息
| 驱动程序类 | 连接字符串 | 驱动存放目录 |
---|
MySQL JDBC Driver | com.mysql.jdbc.Driver
| jdbc:mysql://<HOST>:3306/<database_name>?useOldAliasMetadataBehavior=true&useUnicode=true&characterEncoding=UTF8&zeroDateTimeBehavior=convertToNull&useCursorFetch=true&defaultFetchSize=-2147483648 | 自带 |
ClickHouse JDBC Driver | com.clickhouse.jdbc.ClickHouseDriver
| jdbc:clickhouse://<host>:8123/<database_name>?user=bytehouse&password=<API_Key>&ssl=true&compress=0&server_version=54021&server_time_zone=Asia/Shanghai | ClickHouse |
ByteHouse JDBC Driver | com.bytedance.bytehouse.jdbc.ByteHouseDriver
| jdbc:bytehouse://<host>:19000/<database_name>?user=bytehouse&password=<API_Key>&secure=true&compress=true | ByteHouse |
ByteHouse HTTP JDBC Driver | com.bytedance.jdbc.ByteHouseDriver
| jdbc:clickhouse://<host>:8123/<database_name>?user=bytehouse&password=<API_Key>&ssl=true&compress=false&server_version=54021&server_time_zone=Asia/Shanghai | ByteHouseHTTP |
- <Host> 和 <API_Key>可以在地域及可用区查询,或者访问ByteHouse控制台-租户管理 获取。
- 系统默认用户名为
bytehouse
,密码即 <API_Key>。
配置数据连接
通过 MySQL JDBC Driver 连接
- 登录Smartbi企业报表分析平台,选择 数据连接>关系数据库 ,点击 MySQL 图标进入数据库连接界面。如下图所示:
- 根据 连接信息 中提供的配置信息,输入数据库对应的信息。如下图所示:
通过 ClickHouse JDBC Driver 连接
- 登录Smartbi企业报表分析平台,选择 数据连接 > 所有数据库 ,点击 ByteHouse **** 图标进入数据库连接界面。如下图所示:
- 根据 连接信息 中提供的配置信息,输入数据库对应的信息。其中“选择驱动类型-自定义” 选 Clickhouse。如下图所示:
通过 ByteHouse TCP JDBC Driver 连接
- 登录Smartbi企业报表分析平台,选择 数据连接 > 所有数据库 ,点击 ByteHouse **** 图标进入数据库连接界面。如下图所示:
- 根据 连接信息 中提供的配置信息,输入数据库对应的信息。其中“选择驱动类型-自定义” 选 Bytehouse。如下图所示:
通过 ByteHouse HTTP JDBC Driver 连接
- 登录Smartbi企业报表分析平台,选择 数据连接 > 所有数据库 ,点击 ByteHouse **** 图标进入数据库连接界面。如下图所示:
- 根据 连接信息 中提供的配置信息,输入数据库对应的信息。其中“选择驱动类型-自定义” 选 Bytehousehttp。如下图所示:
连接测试
- 信息正确输入后,点击 测试连接 ,若出现如下图的 测试通过 弹出框,则表示可以成功连接上数据库。如下图所示:
- 测试连接成功后,点击右下角的 保存 按钮,选择数据源的保存位置,保存成功后,该数据连接即添加成功。如下图所示:
- 数据库连接成功后,可以参考Smartbi官方快速入门使用数据查询和管理。