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

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

Community Maintained

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

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

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

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

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

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

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

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