Подключение 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-запросов и выполните запрос.
- Щёлкните правой кнопкой мыши по подключению и выберите команду SQL Editor > Open SQL Script, чтобы открыть редактор запросов:
- Пример запроса к
system.query_log:
Дальнейшие шаги
Подробную информацию о возможностях DBeaver см. в его wiki, а о возможностях ClickHouse — в документации ClickHouse.
