导航
DBeaver（TCP）
最近更新时间：2025.03.28 17:55:04首次发布时间：2023.09.12 16:58:48
DBeaver 社区版是一个免费的跨平台数据库工具，适用于开发人员、数据库管理员和数据分析师。DBeaver 支持所有流行的SQL数据库，如 MySQL、MariaDB、PostgreSQL、SQLite 系列等。
说明
当前TCP模式下不支持分页，如果在工具中预览数据且数据量较大的情况预览将会比较慢。
这种情况下建议使用HTTP协议的方式进行连接，参考DBeaver（ClickHouse）。
准备工作
- 请通过 官方网站 提前下载并安装好 DBeaver 。
注意
推荐使用 24.2.2 及以上版本的 DBeaver，以获得更好的兼容性。
- 点击 这里 获取 ByteHouser JDBC Driver 最新版本的jar文件。
- 您可以在 租户管理-参数设置 页面设置默认连接的计算组/数据库。
配置 ByteHouse 驱动
- 启动 DBeaver，在 数据库 页签下，选择 驱动管理器 。
- 点击“新建”。
- 在设置页签下，如图输入以下信息：
说明
类名： com.bytedance.bytehouse.jdbc.ByteHouseDriver
URL 模板： jdbc:bytehouse://{host}:{port}/?secure=true
默认端口：19000
- 切换到”库“页签，单击 添加文件，选择前面准备的ByteHouse JDBC Driver文件。
- 切换到”高级参数“页签，将下图中的两项配置去掉勾选。
注意
如果忽略此项，查询行数较多的表时可能会出现报错，如：SQL错误[396]: DB::ExceptionDB::Exception: Limit for result exceeded, max rows: 200.00, current rows: 8.19 thousand SQLSTATE: 54000. Stack trace:...
- 点击确定保存。
连接到 ByteHouse
- 点击 数据库 - 新建数据库连接，并在页面中选择 “ByteHouse”，单击 下一步。
- 填写以下字段：
主机、端口：取决于集群所在区域，请参考 支持的地域及可用区 获取。用户名：默认为bytehouse。密码：即<API_KEY>，可以参考 获取 API Key。
- 单击左下角“测试连接”，若显示 已连接 则设置成功。
- 单击 完成 ，即可在 DBeaver 程序主页中操作 ByteHouse 数据库。