跳到主要内容
跳到主要内容

在 DataGrip 中连接 ClickHouse

Community Maintained

启动或下载 DataGrip​

DataGrip 可从 https://www.jetbrains.com/datagrip/ 获取

1. 收集连接信息​

要通过 HTTP(S) 连接到 ClickHouse，您需要以下信息：

参数说明
HOST 和 PORT通常，在使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。
DATABASE NAME默认提供一个名为 default 的数据库，请填写您要连接的目标数据库名称。
USERNAME 和 PASSWORD默认用户名为 default。请使用适合您使用场景的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect：

ClickHouse Cloud 服务 Connect 按钮

选择 HTTPS。连接信息会显示在示例 curl 命令中。

ClickHouse Cloud HTTPS 连接信息

如果您使用的是自托管 ClickHouse，则连接信息由您的 ClickHouse 管理员进行设置。

2. 加载 ClickHouse 驱动程序​

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

选择 ClickHouse

提示

随着你创建更多连接，列表顺序会发生变化，ClickHouse 可能暂时还不会排在列表顶部。

在 DataGrip 中从数据源列表选择 ClickHouse

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

    为了减小下载体积，DataGrip 默认不内置驱动程序。在 Drivers 选项卡中， 从 Complete Support 列表中选择 ClickHouse，展开 + 号。在 Provided Driver 选项中选择 Latest stable 驱动程序：

在 DataGrip 的 Drivers 选项卡中显示 ClickHouse 驱动程序安装

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 driver 仓库。

包含 ClickHouse 设置的 DataGrip 连接详细信息表单

深入了解​

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