将 QStudio 连接至 ClickHouse

QStudio 是一款免费的 SQL 工具。

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

QStudio 通过 JDBC 连接到 ClickHouse。

​

1. 获取 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 管理员配置。

​

2. 下载 QStudio

QStudio 可在 https://www.timestored.com/qstudio/download/ 下载。

​

3. 添加数据库

• 首次打开 QStudio 时，点击菜单中的 Server->Add Server，或点击工具栏上的添加服务器按钮。
• 然后设置以下信息：

1. 服务器类型：Clickhouse.com
2. 注意：Host 必须包含 https:// Host: https://abc.def.clickhouse.cloud Port: 8443
3. 用户名：default 密码：XXXXXXXXXXX
4. 点击 Add

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

​

4. 查询 ClickHouse

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

• Ctrl + e - 运行高亮选中的文本

• Ctrl + Enter - 运行当前行

• 示例查询：

​

后续步骤

请参阅 QStudio，了解 QStudio 的功能；另请参阅 ClickHouse documentation，了解 ClickHouse 的功能。