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

连接 QStudio 到 ClickHouse

Community Maintained

QStudio 是一个免费的 SQL GUI，允许执行 SQL 脚本、轻松浏览表格、创建图表和导出结果。它可以在所有操作系统上，与所有数据库一起工作。

QStudio 使用 JDBC 连接到 ClickHouse。

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

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

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

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

  • HOST 和 PORT：通常情况下，使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。

  • 数据库名称：默认情况下，有一个名为 default 的数据库，请使用您要连接的数据库名称。

  • 用户名和密码：默认情况下，用户名为 default。请使用适合您用例的用户名。

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

ClickHouse Cloud service connect button

选择 HTTPS，并且详细信息可以在一个示例 curl 命令中找到。

ClickHouse Cloud HTTPS connection details

如果您使用自管理的 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 的功能。