Перейти к основному содержанию
Перейти к основному содержанию

Подключение DataGrip к ClickHouse

Community Maintained

Запустите или загрузите DataGrip​

DataGrip доступен на сайте https://www.jetbrains.com/datagrip/

1. Соберите сведения о подключении​

To connect to ClickHouse with HTTP(S) you need this information:

Parameter(s)Description
HOST and PORTTypically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAMEOut of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORDOut of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS. Connection details are displayed in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

2. Загрузите драйвер ClickHouse​

  1. Запустите DataGrip и на вкладке Data Sources в диалоговом окне Data Sources and Drivers нажмите значок +
Вкладка Data Sources в DataGrip с выделенным значком +

Выберите ClickHouse

Совет

По мере настройки подключений порядок будет меняться, и ClickHouse может пока не быть в верхней части списка.

Выбор ClickHouse из списка источников данных в DataGrip

  • Перейдите на вкладку Drivers и загрузите драйвер ClickHouse

    DataGrip не включает драйверы в поставку, чтобы минимизировать размер загрузки. На вкладке Drivers выберите ClickHouse в разделе Complete Support и раскройте значок +. Выберите драйвер Latest stable в параметре Provided Driver:

Вкладка Drivers в DataGrip с установкой драйвера ClickHouse

3. Подключение к ClickHouse​

  • Укажите параметры подключения к базе данных и нажмите Test Connection.
    На первом шаге вы собрали сведения для подключения — укажите адрес хоста, порт, имя пользователя, пароль и имя базы данных, затем проверьте подключение.
Совет

В поле Host укажите только имя хоста (например, your-host.clickhouse.cloud) без какого-либо префикса протокола, такого как https://.

Для подключений к ClickHouse Cloud необходимо добавить ?ssl=true в поле URL после хоста. Полный 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 с настройками ClickHouse

Подробнее​

Дополнительную информацию о DataGrip см. в его документации.