跳转到主内容
跳转到主内容

将 DbVisualizer 连接至 ClickHouse

Community Maintained

启动或下载 DbVisualizer

可以从 https://www.dbvis.com/download/ 下载 DbVisualizer

1. 收集连接信息

要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:

参数说明
HOSTPORT通常,在使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。
DATABASE NAME默认提供一个名为 default 的数据库,请填写您要连接的目标数据库名称。
USERNAMEPASSWORD默认用户名为 default。请使用适合您使用场景的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect

ClickHouse Cloud 服务 Connect 按钮

选择 HTTPS。连接信息会显示在示例 curl 命令中。

ClickHouse Cloud HTTPS 连接信息

如果您使用的是自托管 ClickHouse,则连接信息由您的 ClickHouse 管理员进行设置。

2. 内置 JDBC 驱动管理

DbVisualizer 已预置最新的 ClickHouse JDBC 驱动。它内建完整的 JDBC 驱动管理功能,既支持最新发布版本,也保留历史版本的驱动。

DbVisualizer 驱动管理界面,显示 ClickHouse JDBC 驱动配置

3. 连接到 ClickHouse

要使用 DbVisualizer 连接数据库,首先必须创建并配置一个 Database Connection。

  1. 通过 Database->Create Database Connection 创建一个新连接,并在弹出菜单中为数据库选择相应的驱动程序。

  2. 新连接的 Object View 选项卡会自动打开。

  3. Name 字段中输入连接名称,并可选地在 Notes 字段中输入该连接的说明。

  4. Database Type 保持为 Auto Detect

  5. 如果 Driver Type 中所选驱动旁带有绿色对勾标记,则该驱动已可使用。如果没有绿色对勾标记,则可能需要在 Driver Manager 中配置该驱动。

  6. 在其余字段中输入数据库服务器的相关信息。

  7. 点击 Ping Server 按钮,验证是否可以与指定的地址和端口建立网络连接。

  8. 如果 Ping Server 的结果表明可以访问服务器,点击 Connect 以连接到数据库服务器。

提示

如果在连接数据库时遇到问题,请参阅 Fixing Connection Issues,获取一些排查建议。

了解更多

如需进一步了解 DbVisualizer,请参阅 DbVisualizer 文档