Чтобы создать источник данных для PostgreSQL, первое, что нужно сделать — скачать драйвер JDBC для PostgreSQL. Это можно сделать, например, со страницы

https://jdbc.postgresql.org/download.html

Будьте внимательны: версия драйвера JDBC для PostgreSQL должна соответствовать как версии Java, установленной на компьютере, где будет запускаться отчет, так и версии сервера PostgreSQL. В этом примере используется Java 8 и PostgreSQL 10, поэтому согласно инструкции я скачал драйвер PostgreSQL версии 4.2 (4.2.4, если быть совсем точным). Отметим, что один и тот же драйвер подходит как для Windows, так и для Unix/Linux. Скачанный драйвер в виде файла postgresql-42.2.4.jar я поместил в папку D:\BIRT\PostgresqlJdbcDriver (папка, конечно, может быть любая).

Дальше уже действуем в дизайнере отчетов BIRT. После создания отчета переходим в окно Data Explorer, щелкаем правой кнопкой мыши по контейнеру Data Sources и в контекстном меню выбираем New Data Source (см. рис. 3.3.3.1).

Рис. 3.3.3.1 Первый этап подключения к PostgreSQL — создаем новый источник данных

На первом экране мастера создания нового источника данных (см. рис. 3.3.3.2) оставляем переключатель в положении Create from a data source type in the following list, в списке выбираем JDBC Database Connection for Query Builder и поле с названием источника данных вводим значимое наименование (в этом примере — PostgreSQLDevHR01).

Рис. 3.3.3.2 Второй этап создания подключения к PostgreSQL — выбираем тип источника данных и присваиваем ему название

На следующем экране мастера создания нового источника данных (см. рис. 3.3.3.3), который называется Connection Profile (Профиль подключения) выбираем, конечно, PostgreSQL.

Рис. 3.3.3.3 Третий этап создания подключения к PostgreSQL — выбор типа сервера баз данных

А на следующем экране, который называется Specify a Driver and Connection Details (Укажите дополнительную информацию о драйвере и соединении), нужно будет щелкнуть будет по кнопке New Driver Definition (Новое определение драйвера) справа от списка Drivers(изначально этот список может быть пустым) — см. рис. 3.3.3.4.

Рис. 3.3.3.4 Четвертый этап создания подключения к PostgreSQL —настройка параметров драйвера и подключения

В открывшемся окне (см. рис. 3.3.3.5) нужно перейти на вкладку JAR List, при помощи кнопки Remove JAR/Zip удалить предлагаемый по умолчанию драйвер (все равно его в поставке BIRT нет) и указать наш свежескачанный.

Рис. 3.3.3.5 Пятый этап создания подключения к PostgreSQL — определение файла JAR драйвера

Затем нужно перейти на вкладку Properties (Свойства) и указать параметры подключения (см. рис. 3.3.3.6)

Рис. 3.3.3.6 Параметры подключения к PostgreSQL при настройке драйвера Data Source в BIRT

В поле Connection URL указываются основные параметры подключения:

• имя сервера PostgreSQL. В нашем случае используется локальный сервер, поэтому использовано значение «localhost». Если бы мы подключались к удаленному серверу, то вместо localhost нужно было написать имя этого удаленного сервера (которое можно разрешить в IP-адрес);
• порт сервера PostgreSQL (в нашем случае используется порт по умолчанию 5432);
• наименование базы данных на сервере (в нашем случае — HR01). Его можно прописать как в строке подключения, так и в поле Database Name.

Значение в поле Driver Class лучше оставить по умолчанию.

А в полях User ID и Password указываются логин и пароль для подключения к серверу PostgreSQL (потом вам будет предложено выбрать — сохранять ли пароль в определении отчета или не сохранять; во втором случае придется вводить пароль каждый раз при обращении к серверу PostgreSQL).

Если после заполнения всех свойств кнопка OK будет недоступной, скорее всего, драйвер с таким именем уже присутствует в отчете. Нужно перейти на вкладку Name/Type (см. рис. 3.3.3.7) и ввести новое имя.

Рис. 3.3.3.7 Определение имени для драйвера PostgreSQL

После нажатия кнопки OK вы вернетесь в окно Specify a Driver and Connection Details, которое теперь будет заполнено (см. рис. 3.3.3.8).

Рис. 3.3.3.8 Заполненное окно Specify a Driver and Connection Details мастера создания источника данных при подключении к PostgreSQL

Обратим внимание, что в этом окне:

• есть флажок Save password. Если вы установите этот флажок, то пароль будет сохранен в определении источника данных. Это не очень хорошо с точки зрения безопасности, но иногда приходится на это идти, например, когда отчет должны будут запускать на выполнение пользователи, которым не предоставлен логин/пароль на доступ к базе данных. Отчасти выходом из ситуации может стать применение шифрованного хранилища источников данных;
• есть кнопка Test Connection. Очень рекомендуется нажать, чтобы убедиться, что появляется сообщение «Ping succeeded», и, значит, подключение к базе данных настроено правильно.

На следующем экране мастера можно просмотреть Summary (см. рис. 3.3.3.9) и нажать на кнопку Finish, чтобы завершить создание источника данных для подключения к серверу PostgreSQL.

Рис. 3.3.3.9 Последнее окно мастера создания источника данных BIRT для подключения к PostgreSQL

Вот и все, создание источника данных для подключения к PostgreSQL завершено. В BIRT это делается чуть менее интуитивно, чем в Crystal Reports или Microsoft Reporting Services, но, в принципе, тоже ничего сложного.

Перейти к следующему разделу