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

DataGrip — это IDE для работы с базами данных со встроенной поддержкой ClickHouse.

​

Запустите DataGrip или скачайте его

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

​

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

Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

Параметр(ы)	Описание
HOST and PORT	Обычно используется порт 8443 при использовании TLS и 8123 без TLS.
DATABASE NAME	По умолчанию есть база данных default; используйте имя базы данных, к которой хотите подключиться.
USERNAME and PASSWORD	По умолчанию имя пользователя — default. Используйте имя пользователя, подходящее для вашего сценария использования.

Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

Выберите HTTPS. Сведения о подключении будут показаны в примере команды curl.

Если вы используете самоуправляемый ClickHouse, сведения о подключении задаёт ваш администратор ClickHouse.

​

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

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

Выберите ClickHouse

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

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

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

​

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

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

В поле 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 см. в документации DataGrip.