> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> QStudio 是一款免费的 SQL 工具。
# 将 QStudio 连接至 ClickHouse
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
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/](https://www.timestored.com/qstudio/download/) 下载。
## 3. 添加数据库
* 首次打开 QStudio 时，点击菜单中的 **Server->Add Server**，或点击工具栏上的添加服务器按钮。
* 然后设置以下信息：
1. 服务器类型：Clickhouse.com
2. 注意：Host 必须包含 https\://
Host: [https://abc.def.clickhouse.cloud](https://abc.def.clickhouse.cloud)
Port: 8443
3. 用户名：default
密码：`XXXXXXXXXXX`
4. 点击 Add
如果 QStudio 检测到你尚未安装 ClickHouse JDBC 驱动，它会提示你下载并安装：
## 4. 查询 ClickHouse
* 打开查询编辑器并运行查询。你可以通过以下方式运行查询：
* Ctrl + e - 运行高亮选中的文本
* Ctrl + Enter - 运行当前行
* 示例查询：
## 后续步骤
请参阅 [QStudio](https://www.timestored.com/qstudio)，了解 QStudio 的功能；另请参阅 [ClickHouse documentation](/zh/)，了解 ClickHouse 的功能。