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

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

Community Maintained

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

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

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

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

Параметр(ы)Описание
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're using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

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

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

Выберите ClickHouse

Совет

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

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

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

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

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

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 с настройками ClickHouse

Узнайте больше​

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