Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

将 QStudio 连接至 ClickHouse

由社区维护

QStudio 是一款免费的 SQL 图形界面工具,可用于运行 SQL 脚本、轻松浏览表、生成图表并导出结果。它支持所有操作系统和各种数据库。

QStudio 通过 JDBC 连接到 ClickHouse。

收集你的 ClickHouse 详细信息

QStudio 使用基于 HTTP(S) 的 JDBC 连接到 ClickHouse;你需要准备:

  • 端点
  • 端口号
  • 用户名
  • 密码

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

Parameter(s) Description
HOST and PORT 通常,使用 TLS 时端口为 8443;不使用 TLS 时端口为 8123。
DATABASE NAME 默认情况下,存在一个名为 default 的数据库。请使用你要连接的数据库名称。
USERNAME and PASSWORD 默认情况下,用户名为 default。请根据你的使用场景使用相应的用户名。

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务,然后点击 Connect:

ClickHouse Cloud 服务连接按钮

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

ClickHouse Cloud HTTPS 连接信息

如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。

下载 QStudio

添加数据库

  • 首次打开 QStudio 时,点击菜单 Server->Add Server,或点击工具栏上的 Add Server 按钮。
  • 然后填写详细信息:
显示 ClickHouse 连接设置的 QStudio 数据库连接配置界面
  1. Server Type: ClickHouse.com
  2. 注意:Host 必须包含 https:// Host: https://abc.def.clickhouse.cloud Port: 8443
  3. Username: default Password: XXXXXXXXXXX
  4. 点击 Add

如果 QStudio 检测到你尚未安装 ClickHouse JDBC 驱动,它会提示你下载:

查询 ClickHouse

  • 打开查询编辑器并运行查询。你可以通过以下方式运行查询:

  • Ctrl + e - 运行高亮显示的文本

  • Ctrl + Enter - 运行当前行

  • 示例查询:

QStudio 界面显示针对 ClickHouse 数据库执行的示例 SQL 查询

后续步骤

请参阅 QStudio 了解 QStudio 的功能,并参阅 ClickHouse documentation 了解 ClickHouse 的功能。

Navigation