将 QStudio 连接到 ClickHouse
Community Maintained
QStudio 是一款免费的 SQL 图形界面(GUI)工具,支持运行 SQL 脚本、便捷浏览数据表、绘制图表以及导出结果。它可在所有操作系统上运行,并可连接各种数据库。
QStudio 通过 JDBC 连接到 ClickHouse。
1. 收集 ClickHouse 连接信息
QStudio 通过基于 HTTP(S) 的 JDBC 连接到 ClickHouse。您需要准备:
- endpoint(端点地址)
- 端口号
- 用户名
- 密码
要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:
| 参数 | 说明 |
|---|---|
HOST 和 PORT | 通常,在使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。 |
DATABASE NAME | 默认提供一个名为 default 的数据库,请填写您要连接的目标数据库名称。 |
USERNAME 和 PASSWORD | 默认用户名为 default。请使用适合您使用场景的用户名。 |
您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect:

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

如果您使用的是自托管 ClickHouse,则连接信息由您的 ClickHouse 管理员进行设置。
2. 下载 QStudio
可从 https://www.timestored.com/qstudio/download/ 下载 QStudio
3. 添加数据库
- 第一次打开 QStudio 时,点击菜单选项 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 驱动程序,它会提示您下载:
4. 查询 ClickHouse
-
打开查询编辑器并运行查询。可以通过以下方式运行查询:
-
Ctrl + e - 运行高亮文本
-
Ctrl + Enter - 运行当前行
-
示例查询:

后续步骤
请参阅 QStudio 以了解 QStudio 的功能,并查阅 ClickHouse 文档 以了解 ClickHouse 的功能。