Эта инструкция подойдет аналитикам, которые только знакомятся с IDE для написания SQL-запросов. Статья рассказывает, как подключиться к ClickHouse из IDE. Рассмотрим две IDE: DBeaver и Visual Studio Code. Предполагается, что логин-пароль для подключения выдан, ClickHouse развернут, а задача аналитика — подключиться к нему для написания запросов в IDE.

DBeaver

Так как подключение к ClickHouse осуществляется с помощью SSL сертификата, нужно скачать и подключить сертификат в DBeaver.

1. Установить DBeaver: https://dbeaver.io/download/

2. Скачать SSL сертификат: https://cloud.yandex.ru/docs/managed-clickhouse/operations/connect

   

3. Сохранить сертификат на диск C:/

4. В DBeaver в верхнем меню нажать База данных → Новое соединение

5. Ввести ClickHouse и выбрать подключение

   

6. Заполнить на вкладке Главное поля Хост, Порт, Пользователь, Пароль

   

7. На вкладке SSL добавить путь к SSL сертификату (который вы сохранили на диске C:/ в шаге 3)

   

8. Нажать кнопку Тест соединения в нижнем левом углу окна

9. Соединение установлено успешно, если появилось сообщение «Соединено»

10. Новое подключение появится в левой части DBeaver

    

11. Нажать правойкнопкой мыши на новое соединение → Редактировать объект «Соединение»

12. Задать нужные настройки драйвера на вкладке Свойства драйвера (socket_timeout, use_server_time_zone, use_server_time_zone_for_dates, use_time_zone и т.д.)

    

Visual Studio Code

1. Установить Visual Studio Code: https://code.visualstudio.com/download

2. Повторить шаги 2 и 3 из инструкции для DBeaver

3. Установить расширение SQLTools ClickHouse Driver

   

4. Нажать в левой панели кнопку SQLTools и добавить новое подключение

   

5. Настроить подключение

   • Connection name*: любое

   • Server: https://ваш хост

   • Port:

   • Database: default

   • Username: ваш логин

   • Password mode: Save as plaintext in settings

   • Password: ваш пароль

   • Request timeout in milliseconds: 9999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999

   • Enable TLS: да

   • TLS configuration CA Cert: указать путь к SSL сертификату RootCA.pem, который вы сохранили на шаге 2

6. Проверить подключение через кнопку Test Connection

   

7. Если схемы и таблицы появились в левой части экрана, то сохранить подключение через кнопку Save Connection

8. Создать новый скрипт через кнопку New SQL File

   

9. Запустить скрипт с помощью созданного подключения через кнопку Run.