Настройка Агента для получения данных через JDBC

Скопировать прямую ссылку на статью

JDBC (от англ. Java DataBase Connectivity) — платформенно независимый промышленный стандарт взаимодействия Java-приложений с различными СУБД.

Агент ПОДД поддерживает специализированный протокол для исполнения запросов, эталонная реализация которого представлена JDBC-драйвером. Файл драйвера входит в состав дистрибутива Агента ПОДД. Можно получить по адресу http://<ваш_хост>:8182/api/v1/jdbc-driver (для версии в докере порт - 8192).

Настройка JDBC-сервера осуществляется посредством конфигурационного файла Агента ПОДД application.yml. Откройте файл и при необходимости отредактируйте секцию query_server:

Настройка агента через JDBC 1.png

где port – порт TCP/IP, используемый для подключения по стандарту JDBC.

Запустите Агент ПОДД и проверьте корректность работы JDBC-подключения. В данном примере для проверки мы будем использовать клиентское ПО «DBeaver», скачать которое можно по ссылке: https://dbeaver.io.

Запустите DBeaver, зайдите в меню База данных/Управление драйверами.

В окне менеджера драйверов нажмите кнопку Новый.
В окне создания драйвера, во вкладке Библиотеки нажмите кнопку Добавить файл.
Выберите jar-файл библиотеки JDBC-подключения.

Нажмите кнопку Найти класс. После непродолжительного поиска на выбор будет предложен список доступных классов. Выберите класс «ru.rtlabs.client.jdbc.PoddDriver»:

Настройка агента через JDBC 2.png

Перейдите во вкладку Настройки и укажите параметры:

Имя драйвера: произвольное имя драйвера, например «AgentJdbcDriver»;
Шаблон URL: jdbc:podd://{host}:{port};
Стандартный порт: номер порта TCP/IP, используемого для подключения по стандарту JDBC и указанный в конфигурационном файле application.yml. По умолчанию – 8183.

Поставьте флажки Встроенный, Без авторизации, Пустой пароль и нажмите кнопку ОК.

Настройка агента через JDBC 3.png

Теперь создайте профиль подключения к JDBC-интерфейсу Агента ПОДД.

Для этого:

Откройте меню База данных/Новое соединение. На странице выбора типа соединения, выберите ранее подготовленный драйвер (например, «AgentJdbcDriver») и нажмите кнопку Далее:

Настройка агента через JDBC 4.png

В окне настройки базового соединения задайте параметры хоста, на котором работает Агент ПОДД:

Настройка агента через JDBC 5.png

Соединение создано, теперь можно проверить прохождение запроса до ядра ПОДД.
Для этого нажмите правой кнопкой мыши на только что созданное соединение и выберите пункт меню Подключиться:

Настройка агента через JDBC 6.png

Зайдите в меню Редактор SQL/Открыть SQL скрипт (или нажмите F3).
Введите тестовый запрос «SELECT 1» и нажмите Ctrl+Enter:

Настройка агента через JDBC 7.png

Отсутствие ошибок выполнения и отображение в окне результата запроса в виде записи «1» свидетельствует о том, что:

Агент ПОДД настроен, работает и успешно взаимодействует с ядром ПОДД
JDBC- интерфейс Агента ПОДД функционирует нормально
Вы научились использовать JDBC-интерфейс Агента ПОДД
Теперь вы можете отправлять SQL запросы к витринам, доступ к которым вам предоставлен. Подробнее с синтаксисом SQL-запросов вы можете ознакомиться в документах:

С примером реализации взаимодействия своих приложений с Агентом ПОДД посредством JDBC-соединения вы можете ознакомиться в документе «Руководство администратора Агента ПОДД СМЭВ».

, чтобы оставить комментарий к статье