DBeaver（TCP）

DBeaver 社区版是一个免费的跨平台数据库工具，适用于开发人员、数据库管理员和数据分析师。DBeaver 支持所有流行的SQL数据库，如 MySQL、MariaDB、PostgreSQL、SQLite 系列等。

准备工作

1. 请通过 官方网站 提前下载并安装好 DBeaver 。
2. 从 ByteHouser JDBC Driver 的 发布页面 获取最新版本的jar文件。

请从 最新的目录 中下载jar文件，文件名格式为："driver-java-<版本号>-all.jar"。

使用限制

当使用Bytehouse JDBC TCP驱动程序进行连接时，设置项 max_result_rows可能不生效。因此，分页功能没有得到很好的支持。预期返回的行可能与实际返回的行不同。

配置 ByteHouse 驱动

1. 启动 DBeaver，在 数据库 页签下，选择 驱动管理器 。

2. 点击“新建”。

3. 在设置页签下，如图输入以下信息：

4. 切换到”库“页签，单击 添加文件，选择前面准备的ByteHouse JDBC Driver文件。

5. 点击确定保存。

连接到 ByteHouse

1. 点击 数据库 - 新建数据库连接，并在页面中选择 “ByteHouse”，单击 下一步。

2. 填写以下字段：
   1. 主机、端口：取决于集群所在区域，请参考 支持的地域及可用区 获取。
   2. 用户名：默认为bytehouse。
   3. 密码： <API_TOKEN>值，可以参考 获取 API Token 获取。

3. 单击左下角“测试连接”，若显示 已连接 则设置成功。

4. 单击 完成 ，即可在 DBeaver 程序主页中操作 ByteHouse 数据库。