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

1. 请通过 官方网站 提前下载并安装好 DBeaver 。

   注意

   推荐使用 24.2.2 及以上版本的 DBeaver，以获得更好的兼容性。

2. 从 ByteHouser HTTP Driver 的 发布页面 获取最新版本的jar文件。

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

3. 您可以在 租户管理-参数设置 页面设置默认连接的计算组/数据库。
   

1. 启动 DBeaver，在 数据库 页签下，选择 驱动管理器 。
   
2. 点击“新建”。
   
3. 为驱动设置一个名称，如“ByteHouse HTTP”。在设置页签下，如图输入以下信息：
   
   • 类名： com.bytehouse.jdbc.ByteHouseDriver
   • URL 模板： jdbc:clickhouse://{host}:{port}/
   • 默认端口：8123
4. 切换到”库“页签，单击 添加文件，选择前面准备的ByteHouse HTTP Driver文件。
   
5. 点击确定保存。

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

2. 配置数据库连接字段。
   

   • 主机、端口：取决于集群所在区域，请参考 支持的地域及可用区 获取。
   • 用户名：默认为bytehouse。
   • 密码： 即<API_KEY>，可以参考 获取 API Key。

3. 在驱动属性页签配置驱动属性参数：compress 和 ssl 。
   
   

   compress = false   // 0
   ssl = true
   

4. （可选）在驱动属性页签配置默认计算组。

   说明

   如果您有多个计算组，连接ByteHouse后使用的默认计算组，可参考本步骤设置默认计算组；如果不设置，则连接ByteHouse后使用控制台设置的默认计算组。

   

   • 设置custom_settings为 virtual_warehouse=your_virtualwarehouse_id。
   • 其中your_virtualwarehouse_id为连接ByteHouse后使用的默认计算组ID，您可以在ByteHouse控制台的计算组页面查看对应计算组的ID。

5. 切换回主要页签，单击左下角“测试连接”，若显示 已连接 则设置成功。

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