Подключение DBeaver к ClickHouse
DBeaver доступен в нескольких редакциях. В этом руководстве используется DBeaver Community. С различными редакциями и их возможностями можно ознакомиться здесь. DBeaver подключается к ClickHouse с помощью JDBC.
Используйте DBeaver версии 23.1.0 или новее для улучшенной поддержки столбцов типа Nullable в ClickHouse.
1. Соберите информацию о вашем экземпляре ClickHouse
DBeaver использует JDBC поверх HTTP(S) для подключения к ClickHouse, для этого вам понадобятся:
- конечная точка (endpoint)
- номер порта
- имя пользователя
- пароль
2. Скачайте DBeaver
DBeaver доступен для загрузки по адресу https://dbeaver.io/download/
3. Добавьте базу данных
- Используйте меню Database > New Database Connection либо значок New Database Connection в Database Navigator, чтобы открыть диалоговое окно Connect to a database:
-
Выберите Analytical, затем ClickHouse:
-
Сформируйте JDBC URL. На вкладке Main укажите Host, Port, Username, Password и Database:
- По умолчанию свойство SSL > Use SSL отключено. Если вы подключаетесь к ClickHouse Cloud или серверу, который требует SSL на HTTP-порту, включите SSL > Use SSL:
- Проверьте соединение:
Если DBeaver обнаружит, что драйвер ClickHouse не установлен, он предложит загрузить его:
- После загрузки драйвера снова нажмите Test, чтобы проверить соединение:
4. Выполнение запросов к ClickHouse
Откройте редактор запросов и выполните запрос.
- Щёлкните правой кнопкой мыши по подключению и выберите SQL Editor > Open SQL Script, чтобы открыть редактор запросов:
- Пример запроса к
system.query_log:
Дальнейшие шаги
Подробнее о возможностях DBeaver см. в DBeaver wiki, а о возможностях ClickHouse — в документации ClickHouse.
