在 DataGrip 中连接 ClickHouse
启动或下载 DataGrip
可从 https://www.jetbrains.com/datagrip/ 下载 DataGrip
1. 收集连接信息
要通过 HTTP(S) 连接到 ClickHouse，您需要以下信息：
| 参数 | 说明 |
|---|---|
HOST 和 PORT | 通常，在使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。 |
DATABASE NAME | 默认提供一个名为 default 的数据库，请填写您要连接的目标数据库名称。 |
USERNAME 和 PASSWORD | 默认用户名为 default。请使用适合您使用场景的用户名。 |
您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect：
选择 HTTPS。连接信息会显示在示例 curl 命令中。
如果您使用的是自托管 ClickHouse，则连接信息由您的 ClickHouse 管理员进行设置。
2. 加载 ClickHouse 驱动程序
- 启动 DataGrip，在 Data Sources and Drivers 对话框的 Data Sources 选项卡中，点击 + 图标
选择 ClickHouse
随着你建立更多连接，列表顺序会发生变化，ClickHouse 可能暂时还不会排在列表顶部。
-
切换到 Drivers 选项卡并加载 ClickHouse 驱动程序
为了尽量减小下载包大小，DataGrip 默认不内置驱动程序。在 Drivers 选项卡中， 从 Complete Support 列表中选择 ClickHouse，然后展开 + 图标。从 Provided Driver 选项中选择 Latest stable 驱动程序：
3. 连接到 ClickHouse
- 指定数据库连接信息，然后点击 Test Connection。
在第 1 步中已收集连接信息——填写主机 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 driver 仓库。
了解更多
如需了解更多关于 DataGrip 的信息，请参阅 DataGrip 文档。
