Как подключиться к встраиваемой базе данных VistaDB
База данных Vista относится к типу встраиваемых баз. Эти базы отличаются от клиент серверных СУБД тем, что предназначены для встраивания в клиентское приложение в виде файла. Круг задач такой базы также отличается от СУБД. Как правило, это базы которые используются только в одном приложении и не предназначены для совместного использования. Таким образом VistaDB встает в один ряд с SQLite и SQL Ce.
Рассмотрим, как создать подключение к такой базе данных внутри отчета. Для этого нам потребуется подключить к дизайнеру отчета плагин-коннектор, расположенный в папке:
C:\Program Files (x86)\FastReports\FastReport.Net\Extras\Connections\FastReport.VistaDB
Итогом сборки этого проекта будет библиотека FastReport.VistaDB.dll.
Открываем дизайнер отчета, меню File->Options:
На вкладке Plugins добавляем ссылку на созданную нами ранее библиотеку FastReport.VistaDB.dll. После этого перезапускаем дизайнер отчетов.
Добавляем новый источник данных в отчет. При создании подключения, выбираем доступную теперь VistaDB connection:
Настройка подключения сводится к выбору файла базы данных и вводу пароля к ней, если задан.
Далее переходим к выбору таблиц:
Тут мы можем выбрать таблицу и завершить создание источника данных. Однако, есть возможность отфильтровать данные с помощью SQL запроса. Для этого нажимаем кнопку “Add SQL query…”.
Задаем имя представления данных, которое появится в списке таблиц после создания запроса:
Пишем сам SQL запрос:
Тут мы использовали параметризированный запрос. Сам параметр мы объявим на следующем шаге мастера создания запроса:
Имя параметра соответствует параметру в запросе. Значение параметра может быть любым выражением: функцией, текстом, переменной отчета, системной переменной. Не забудьте, также определить тип данных параметра. Он должен соответствовать полю данных, с которым мы сравниваем параметр в запросе. В итоге мы получим новую «кастомную» таблицу:
Мы использовали в качестве значения параметра запроса параметр отчета:
В итоге мы получим следующие данные:
Использование плагина для подключения к VistaDB облегчает и ускоряет процесс создания источника данных, а использование параметризированного запроса для фильтрации данных позволяет передать в фильтр значение параметра извне отчета (используя код приложения или через URL).
