由社区维护
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:

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

如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。
下载 QStudio
QStudio 可从 https://www.timestored.com/qstudio/download/ 下载
添加数据库
- 首次打开 QStudio 时,点击菜单 Server->Add Server,或点击工具栏上的 Add Server 按钮。
- 然后填写详细信息:

- Server Type: ClickHouse.com
- 注意:Host 必须包含 https:// Host: https://abc.def.clickhouse.cloud Port: 8443
- Username: default
Password:
XXXXXXXXXXX - 点击 Add
如果 QStudio 检测到你尚未安装 ClickHouse JDBC 驱动,它会提示你下载:
查询 ClickHouse
-
打开查询编辑器并运行查询。你可以通过以下方式运行查询:
-
Ctrl + e - 运行高亮显示的文本
-
Ctrl + Enter - 运行当前行
-
示例查询:

后续步骤
请参阅 QStudio 了解 QStudio 的功能,并参阅 ClickHouse documentation 了解 ClickHouse 的功能。