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