跳到主要内容

DBeaver

DBeaver 支持通过内置驱动连接 Databend,该驱动归类在 Analytical 类别下,从 24.3.1 版本开始提供。

前提条件

  • 已安装 DBeaver 24.3.1 或更高版本
  • 对于私有化部署的 Databend:已安装 Docker (如果使用 Docker 部署)

用户认证

如果您连接的是私有化部署的 Databend 实例,可以使用 databend-query.toml 配置文件中指定的管理员用户,或者通过 CREATE USER 命令创建的 SQL 用户进行连接。

对于连接 Databend Cloud,可以使用默认的 cloudapp 用户或通过 CREATE USER 命令创建的 SQL 用户。请注意,用于登录 Databend Cloud 控制台 的用户账号不能用于连接 Databend Cloud。

连接私有化部署的 Databend

1

启动 Databend (Docker)

运行以下命令启动 Databend 实例:

备注

如果在启动容器时没有为 QUERY_DEFAULT_USERQUERY_DEFAULT_PASSWORD 指定自定义值,将会创建一个默认的 root 用户且无密码。

docker run -d --name databend \
-p 3307:3307 -p 8000:8000 -p 8124:8124 -p 8900:8900 \
datafuselabs/databend:nightly
2

配置连接

  1. 在 DBeaver 中,转到 Database > New Database Connection 打开连接向导,然后在 Analytical 类别下选择 Databend

alt text

  1. Username 字段输入 root (或您配置的用户名)。

alt text

  1. 点击 Test Connection 验证连接。如果是首次连接 Databend,会提示下载驱动。点击 Download 继续。

alt text

下载完成后,测试连接应会成功:

alt text

连接 Databend Cloud

1

获取连接信息

登录 Databend Cloud 获取连接信息。更多信息请参阅 连接计算集群

alt text

备注

如果您的 userpassword 包含特殊字符,需要分别在对应字段中提供(例如 DBeaver 中的 UsernamePassword 字段)。这种情况下 Databend 会为您处理必要的编码。但如果您将凭据一起提供(例如作为 user:password),则必须确保整个字符串在使用前已正确编码。

2

配置连接

  1. 在 DBeaver 中,转到 Database > New Database Connection 打开连接向导,然后在 Analytical 类别下选择 Databend

alt text

  1. Main 标签页中,根据上一步获取的连接信息输入 HostPortUsernamePassword

alt text

  1. Driver properties 标签页中,根据上一步获取的连接信息输入 Warehouse 名称。

alt text

  1. SSL 标签页中,勾选 Use SSL 复选框。

alt text

  1. 点击 Test Connection 验证连接。如果是首次连接 Databend,会提示下载驱动。点击 Download 继续。下载完成后,测试连接应会成功:

alt text