> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> DataGrip 是一款原生支持 ClickHouse 的数据库 IDE。
# 将 DataGrip 连接到 ClickHouse
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
## 启动或下载 DataGrip
DataGrip 可从 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/) 获取。
要通过 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 管理员配置。
1. 启动 DataGrip，然后在 **Data Sources and Drivers** 对话框的 **Data Sources** 选项卡中，点击 **+** 图标
选择 **ClickHouse**
建立连接后，列表顺序会发生变化，因此 ClickHouse 可能还没有出现在列表顶部。
* 切换到 **Drivers** 选项卡并加载 ClickHouse 驱动
为了尽量减小下载体积，DataGrip 并不自带驱动。在 **Drivers** 选项卡中，
从 **Complete Support** 列表中选择 **ClickHouse**，然后展开 **+** 号。从 **Provided Driver** 选项中选择 **Latest stable** 驱动：
* 填写数据库连接信息，然后点击 **Test Connection**。
在第一步中，你已经收集了连接信息——填写主机 URL、端口、用户名、密码和数据库名称，然后测试连接。
在 **Host** 字段中仅输入主机名 (例如：`your-host.clickhouse.cloud`) ，不要包含任何类似 `https://` 的协议前缀。
对于 ClickHouse Cloud 连接，你必须在主机下方的 **URL** 字段中添加 `?ssl=true`。完整的 JDBC URL 应如下所示：
`jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true`
ClickHouse Cloud 要求所有连接都使用 SSL 加密。如果没有 `?ssl=true` 参数，即使凭据正确，也会出现“Connection reset”错误。
有关 JDBC URL 设置的更多详细信息，请参阅 [ClickHouse JDBC 驱动](https://github.com/ClickHouse/clickhouse-java) 仓库。
## 了解更多
如需了解 DataGrip 的更多信息，请参阅 DataGrip 文档。
