跳到主要内容
跳到主要内容

将 QStudio 连接到 ClickHouse

Community Maintained

QStudio 是一个免费的 SQL GUI，允许运行 SQL 脚本、轻松浏览表格、绘制图表和导出结果。它适用于所有操作系统和所有数据库。

QStudio 通过 JDBC 连接到 ClickHouse。

1. 收集你的 ClickHouse 详细信息​

QStudio 使用 HTTP(S) 上的 JDBC 连接到 ClickHouse；你需要：

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

要通过 HTTP(S) 连接到 ClickHouse，您需要以下信息：

  • 主机和端口：通常，当使用 TLS 时端口为 8443，当不使用 TLS 时端口为 8123。

  • 数据库名称：开箱即用时，有一个名为 default 的数据库，请使用您要连接的数据库名称。

  • 用户名和密码：开箱即用时，用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中获得。 选择您要连接的服务并点击 连接：

ClickHouse Cloud 服务连接按钮

选择 HTTPS，详细信息可在示例的 curl 命令中获得。

ClickHouse Cloud HTTPS 连接详细信息

如果您使用的是自管理的 ClickHouse，连接详细信息由您的 ClickHouse 管理员设置。

2. 下载 QStudio​

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

3. 添加数据库​

  • 当你第一次打开 QStudio 时，点击菜单选项 Server->Add Server 或工具栏上的添加服务器按钮。
  • 然后设置详细信息：
QStudio 数据库连接配置界面显示 ClickHouse 连接设置
  1. 服务器类型：Clickhouse.com
  2. 注意：对于主机，你必须包含 https:// 主机： https://abc.def.clickhouse.cloud 端口： 8443
  3. 用户名：default 密码： XXXXXXXXXXX
  4. 点击添加

如果 QStudio 检测到你没有安装 ClickHouse JDBC 驱动程序，它会提供下载链接：

4. 查询 ClickHouse​

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

  • Ctrl + e - 运行高亮文本

  • Ctrl + Enter - 运行当前行

  • 一个示例查询：

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

下一步​

请参阅 QStudio 了解 QStudio 的功能，以及 ClickHouse 文档 了解 ClickHouse 的功能。