Подключение через DBeaver¶
В данном разделе описан способ подключения к Picodata c помощью DBeaver — удобного инструмента для работы с БД при помощи графического интерфейса.
Общие сведения¶
DBeaver — универсальный SQL-клиент для администрирования баз данных. Для подключения к реляционным БД (включая Picodata) он использует JDBC-драйверы.
Picodata предоставляет обособленный драйвер picodata-jdbc для внешних подключений, разработанный на основе протокола PostgreSQL. Описание возможностей и структуры драйвера приведено отдельно.
Требования¶
Для подключения к Picodata c помощью DBeaver требуются:
- установленный DBeaver
- JDBC-драйвер
postgresql-*.jar
(доступен на сайте PostgreSQL) - JDBC-драйвер
picodata-jdbc-*.jar
(доступен в репозитории Picodata) - доступ к запущенному инстансу Picodata, который принимает входящие подключения по протоколу PostgreSQL
Подключение¶
Добавление драйвера¶
Создайте в DBeaver новый драйвер для Picodata:
База данных > Управление драйверами > Новый (Database > Driver Manager > New)
На вкладке Настройки введите:
- имя драйвера:
Picodata
- имя класса:
io.picodata.jdbc.Driver
- шаблон URL:
jdbc:picodata://{host}:{port}/?
- стандартный порт: укажите номер порта, заданный для параметра PG_LISTEN инстанса Picodata (обычно это
5432
) - стандартный логин: укажите, под каким пользователем DBeaver будет предлагать подключиться к Picodata
Также включите параметр Propagate driver properties
. Остальные настройки оставьте как есть. Пример заполнения показан ниже:
На вкладке Библиотеки:
- нажмите
Добавить файл
и выберите два JAR-файла (postgresql-*.jar
иpicodata-jdbc-*.jar
) - под списком файлов нажмите
Найти класс
и выберитеio.picodata.jdbc.Driver
Пример заполнения показан ниже:
Нажмите ОК
.
Подключение к Picodata¶
После того как драйвер добавлен, можно создать новое соединение к Picodata:
База данных > Новое соединение (Database > New database connection)
Выберите ранее созданный драйвер Picodata
и нажмите Далее, после
чего откроется окно с подробностями соединения:
Проверьте правильность настроек на этом экране. Обратите внимание, что в
блоке Аутентификация (Database native)
должны быть заданы корректные
имя и пароль существующего в Picodata пользователя.
См. также:
Нажмите кнопку Тест соединения (Test connection). Если данные для подключения были указаны корректно, появится окно с данными сервера СУБД и драйвера, задействованного для подключения к нему:
Нажмите Готово
.
Проверка работы¶
После того как подключение добавлено, нажмите на имя узла в левой панели DBeaver. Приложение подключится к Picodata и откроет дерево доступных элементов (таблицы, представления и т.д.). В основной части окна будет доступна SQL-консоль для взаимодействия с БД:
На этом настройка DBeaver для работы с Picodata завершена.