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

准备工作

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

  注意

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

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

使用限制

建议在ByteHouse 云数仓 2.2.0以上版本使用MySQL方式连接，以获得更好体验。您可以在 ByteHouse控制台-租户管理 页面，看到当前服务版本号。

连接到 ByteHouse

1. 点击 数据库 - 新建数据库连接，并在页面中选择 “ClickHouse”，单击 下一步。
   
2. 填写以下字段：
   
   • 主机、端口：取决于集群所在区域，请参考 支持的地域及可用区 获取。
   • 用户名：默认为bytehouse。
   • 密码： 即<API_KEY>，可以参考 获取 API Key。
3. 切换到SSL页面，启用SSL功能。
   
4. （可选）在驱动属性页签配置默认计算组。

   说明

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

   
   • 设置custom_settings为 virtual_warehouse=your_virtualwarehouse_id。
   • 其中your_virtualwarehouse_id为连接ByteHouse后使用的默认计算组ID，您可以在ByteHouse控制台的计算组页面查看对应计算组的ID。
5. 单击左下角“测试连接”，若显示 已连接 则设置成功。
   
6. 单击 完成 ，即可在 DBeaver 程序主页中操作 ByteHouse 数据库。