Эта инструкция подойдет аналитикам, которые только знакомятся с IDE для написания SQL-запросов. Статья рассказывает, как подключиться к ClickHouse из IDE. Рассмотрим две IDE: DBeaver и Visual Studio Code. Предполагается, что логин-пароль для подключения выдан, ClickHouse развернут, а задача аналитика - подключиться к нему для написания запросов в IDE.
DBeaver
Так как подключение к ClickHouse осуществляется с помощью SSL сертификата, нужно скачать и подключить сертификат в DBeaver.
Установить DBeaver: https://dbeaver.io/download/
-
Скачать SSL сертификат: https://cloud.yandex.ru/docs/managed-clickhouse/operations/connect
Сохранить сертификат на диск C:/
В DBeaver в верхнем меню нажать База данных → Новое соединение
-
Ввести ClickHouse и выбрать подключение
-
Заполнить на вкладке Главное поля Хост, Порт, Пользователь, Пароль
-
На вкладке SSL добавить путь к SSL сертификату (который вы сохранили на диске C:/ в шаге 3)
Нажать кнопку Тест соединения в нижнем левом углу окна
Соединение установлено успешно, если появилось сообщение "Соединено"
-
Новое подключение появится в левой части DBeaver
Нажать правой кнопкой мыши на новое соединение → Редактировать объект "Соединение"
-
Задать нужные настройки драйвера на вкладке Свойства драйвера (socket_timeout, use_server_time_zone, use_server_time_zone_for_dates, use_time_zone и т.д.)
Visual Studio Code
Установить Visual Studio Code: https://code.visualstudio.com/download
Повторить шаги 2 и 3 из инструкции для DBeaver
Установить расширение SQLTools ClickHouse Driver
Нажать в левой панели кнопку SQLTools и добавить новое подключение
Настроить подключение
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
Проверить подключение через кнопку Test Connection
Если схемы и таблицы появились в левой части экрана, то сохранить подключение через кнопку Save Connection
Создать новый скрипт через кнопку New SQL File
Запустить скрипт с помощью созданного подключения через кнопку Run.