跳至主要内容

qStudio

qStudio 是一款免费的 SQL GUI，它允许运行 SQL 脚本、轻松浏览表、绘制图表和导出结果。它可以在任何操作系统上使用，并且兼容所有数据库。

将 QStudio 连接到 ClickHouse

QStudio 使用 JDBC 通过 HTTP(S) 连接到 ClickHouse。

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

QStudio 使用 JDBC 通过 HTTP(S) 连接到 ClickHouse；您需要

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

要使用 HTTP(S) 连接到 ClickHouse，您需要以下信息

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

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

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

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中找到。选择您要连接的服务，然后点击 **连接**

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 时，点击菜单选项 **服务器->添加服务器** 或工具栏上的添加服务器按钮。
  • 然后设置详细信息

Configure a new database

  1. 服务器类型：Clickhouse.com
  2. 主机注意：您必须包含 https:// 主机：https://abc.def.clickhouse.cloud 端口：8443
  3. 用户名：default 密码：XXXXXXXXXX
  4. 点击添加

如果 qStudio 检测到您未安装 ClickHouse JDBC 驱动程序，它会提供下载驱动程序的选项

4. 查询 ClickHouse​

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

  • Ctrl + e - 运行突出显示的文本

  • Ctrl + Enter - 运行当前行

  • 一个示例查询

    A sample query

下一步​

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