将 DataGrip 连接到 ClickHouse

DataGrip 是一款原生支持 ClickHouse 的数据库 IDE。

​

启动或下载 DataGrip

DataGrip 可在 https://www.jetbrains.com/datagrip/ 下载

​

1. 获取连接信息

要通过 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. 加载 ClickHouse 驱动程序

1. 启动 DataGrip，在 Data Sources and Drivers 对话框的 Data Sources 选项卡中，点击 + 图标

选择 ClickHouse

随着你建立的连接增多，列表顺序会发生变化，因此 ClickHouse 可能还不在列表顶部。

• 切换到 Drivers 选项卡并加载 ClickHouse 驱动程序

  DataGrip 默认不附带驱动程序，以尽量减小下载体积。在 Drivers 选项卡中， 从 Complete Support 列表中选择 ClickHouse，然后点击展开 + 号。在 Provided Driver 选项中选择 Latest stable 驱动程序：

​

3. 连接到 ClickHouse

• 填写数据库连接信息，然后点击 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 驱动 仓库。

​

了解更多

如需了解 DataGrip 的更多信息，请参阅 DataGrip 文档。