Firebird

Статьи и часто задаваемые вопросы

Установка и настройка

• Самостоятельная сборка снапшота Firebird

• Установка Firebird из снапшота

• Установка firebird на Linux

• Скрипт для резервирования базы данных на Python

• Скрипт для резервирования базы данных на shell

• Как установить на LINUX второй экземпляр Firebird

• Подлючение к базе данных из 1С

Полезные запросы SQL

• SQL000. Математические операции с датой

• SQL001. Отбор множества записей по ключам

• SQL002. Является ли строка числом

• SQL003. Сумма прописью

• SQL004. Можно ли в Firebird делать запросы к нескольким базам данных

• SQL005. Как в строку вставить произвольный символ ?

• SQL006. Как в строку вставить перенос строки (CRLF) ?

• SQL007. Отбор множества записей по ключам из другой таблицы (обход конструкции IN)

• SQL008. Полезные хранимые процедуры для обслуживание индексов

• SQL009. Формирование штрих-кода EAN13 по коду записи в таблице

• SQL010. Выборка данных из «древовидной таблицы» с учетом иерархии объектов

• SQL011. Обмен данными между базами с помощью EXTENDENT (экспортируемых) таблиц

• SQL012. Посчитать контрольный разряд к СНИЛС

Статьи и часто задаваемые вопросы

Установка и настройка

• Самостоятельная сборка снапшота Firebird

• Установка Firebird из снапшота

• Установка firebird на Linux

• Скрипт для резервирования базы данных на Python

• Скрипт для резервирования базы данных на shell

• Как установить на LINUX второй экземпляр Firebird

• Подлючение к базе данных из 1С

Полезные запросы SQL

• SQL000. Математические операции с датой

• SQL001. Отбор множества записей по ключам

• SQL002. Является ли строка числом

• SQL003. Сумма прописью

• SQL004. Можно ли в Firebird делать запросы к нескольким базам данных

• SQL005. Как в строку вставить произвольный символ ?

• SQL006. Как в строку вставить перенос строки (CRLF) ?

• SQL007. Отбор множества записей по ключам из другой таблицы (обход конструкции IN)

• SQL008. Полезные хранимые процедуры для обслуживание индексов

• SQL009. Формирование штрих-кода EAN13 по коду записи в таблице

• SQL010. Выборка данных из «древовидной таблицы» с учетом иерархии объектов

• SQL011. Обмен данными между базами с помощью EXTENDENT (экспортируемых) таблиц

• SQL012. Посчитать контрольный разряд к СНИЛС

Как вести логи изменений данных пользователями в базе данных, сохраняя их в другой базе данных

Уважаемые читатели. Это вторая статья из цикла по базам данных. Решил сделать некоторое оглавление по планируемым статьям этого цикла:

1. Как сделать разный часовой пояс в разных базах данных на одном сервере.
2. Как вести логи изменений данных пользователями в базе данных, сохраняя их в другой базе данных, для того чтобы основная база данных не забивалась мусором и не росла.
3. Как создать свою файловую систему на основе blob полей в базе данных. Почему это удобно. Вопросы эффективности хранения файлов: как получить максимальное быстродействие и при этом минимальное занимаемое место.

Я был удивлен количеством комментариев к первой статье, поэтому сразу хочу заметить, что не претендую на единственно правильный способ реализации. Я уверен, что творческие люди найдут еще немало других способов реализовать данную задачу. Но реализуя ее в свое время, я не нашел ни одной статьи с описанием такого функционала и делать данную задачу пришлось с нуля, хотя она на мой взгляд актуальна. Реализация, которую я буду описывать, полностью рабочая и используется мной на практике.
Так же я приветствую конструктивную критику. Бывает люди пишут интересные вещи и ты можешь взглянуть на проблему под углом, о котором не предполагал и как-то улучшить свои механизмы.
Итак начнем.
База данных firebird 3.
Формулировка задачи следующая: необходимо писать подробные логи изменений данных пользователями в базе данных (insert, update, delete), но при этом писать их в другой базе данных на другом сервере. Необходимо это для того чтобы размер основной базы данных не рос как на дрожжах, ее удобно было бекапить, ресторить, чтобы она работала быстро, не накапливала мусора, не содержала лишней и редконужной информации.

Установка Firebird — выбор типа сервера

Сервер Firebird SQL доступен в 3-х вариантах:

• Firebird Super Server
• Firebird Classic Server
• Firebird Embedded

Firebird Super Server

Firebird Super Server — все клиентские подключения обслуживаются одним серверным процессом, имеется общий клиентский кеш. За счет этого достигается меньший расход ресурсов на обслуживание клиентов. Недостатком Firebird Super Server является отсутствие возможности задействовать несколько процессоров для работы Firebird сервера.

Firebird Classic Server

Firebird Classic Server — на каждое клиентское подключение создает отдельный серверный процесс. Архитектура Firebird Classic Server более надежна, т.к. сбой одного серверного процесса не вызывает отказ в обслуживании всех клиентов. Кроме того, Firebird Classic позволяет задействовать многопроцессорную архитектуру. При установке Firebird вы можете выбрать между версиями Firebird Super Server или Firebird Classic Server.

Firebird Embedded

Firebird Embedded Server — предназначен для встраиваемых баз данных. Состоит из одной dll — fbembed.dll, которая включает в себя клиент и сервер Firebird Super Server. Firebird Embedded не требует установки на клиентской рабочей станции. Достаточно просто скопировать fbembed.dll и еще несколько файлов клиенту на компьютер.

Недостаток Firebird Embedded — это невозможность одновременного подключения к одной БД нескольких клиентов. После успешного подключения Firebird Embedded блокирует файл базы данных для монопольного доступа.

Firebird Embedded Server распространяется отдельным дистрибутивом.

Скачать архив с Firebird Embedded.

Если затрудняетесь с выбором

Если вы не уверены в выборе типа установки Firebird, то используйте Firebird Super Server. В дальнейшем вы без труда сможете изменить архитектуру сервера.

Установка

В Windows встроенный Firebird и обычные клиентские библиотеки Firebird — это разные файлы. Встроенный Firebird всегда может служить обычным клиентом, что делает его логичным выбором для включения в вашу установку.

Windows

Загрузите и разархивируйте комплект embedded Firebird. Убедитесь, что файлы .dll и .manifest находятся либо:

• в каталоге вашего проекта и в каталоге исполняемых файлов (где генерируется .exe), либо
• в каталоге в вашем PATH (не в системном каталоге) (полезно, если вы не хотите сохранять скопированные dll)

Обратите внимание, что битность должна совпадать: вы должны использовать embedded x64 версию, если вы компилируете свою программу под 64-бит, и embedded x32, если вы пишете 32-битные программы. Также убедитесь, что файлы .dlls и .manifest размещены в выходном (исполняемом) каталоге вашего проекта, и распространяйте их вместе с приложениями и файлами лицензий.. Как указание, минимально необходимыми файлами для Firebird 2.5 являются:

Как указание, минимально необходимыми файлами для Firebird 2.5 являются:

• fbembed.dll
• firebird.msg
• ib_util.dll
• icudt30.dll
• icuin30.dll
• icuuc30.dll
• IDPLicense.txt
• IPLicense.txt
• Microsoft.VC80.CRT.manifest
• msvcp80.dll
• msvcr80.dll

Linux

Для Debian, вероятно, похоже на Ubuntu:
получите файлы библиотеки, а также символическую ссылку: например, /usr/lib/x86_64-linux-gnu/libfbembed.so linking для /user/lib/x86_64-linux-gnu/libfbembed.so.bla.x.y

aptitude install libfbembed2.5 firebird-dev

По крайней мере, для Firebird 2.5+: не указывайте имя пользователя или пароль, так как это приведет к поиску security.fdb, что может привести к сбою в случае невозможности доступа к общесистемному security.fdb. Укажите роль RDB$ADMIN в Firebird 2.5+, так как она должна дать вам полный контроль над файлом базы данных.

Поместите эти файлы в каталог вашего проекта (для этого: проверьте, все ли это необходимо):

firebird/libfbembed.so (или возможно libfbembed.so.2.5)
firebird.conf
firebird/security.fdb #возможно, нет необходимости 
firebird/intl/fbintl
firebird/udf/fbudf.so

Для Firebird 3 вам понадобится:

firebird/libfbclient.so
plugins/libEngine12.so

Вам нужно изменить переменную каталога плагинов. Если вы не можете этого сделать, вам нужно поместить libEngine в его оригинальный каталог.

Установите это в firebird.conf (для этого: проверьте, все ли это необходимо)

RootDirectory=./firebird #замените на ваш каталог
DatabaseAccess = Full #наверное полезно
ExternalFileAccess = Full #наверное полезно
UdfAccess = Full #наверное полезно
#disable
#TempDirectories = /tmp #=> не удалось исправить проблемы блокировки /tmp/firebird
#TempDirectories = ~/tmp #=> не удалось исправить проблемы блокировки /tmp/firebird

Перед запуском приложения необходимо установить 2 переменные среды. Предположим, что приложение установлено в /home/pascaldev/embed:

# сообщаем динамическому загрузчику, где найти embedded lib:
LD_LIBRARY_PATH=/home/pascaldev/embed/firebird
# сообщаем серверу, где искать файлы (сообщения, настройки и т. д.)
FIREBIRD=. #или используйте абсолютный путь: /home/pascaldev/embed

Если вы поймали ошибку такую, как

EIBDatabaseError/ : DoInternalConnect :
 -Can't access lock files' directory /tmp/firebird

возможно, у вас лежат устаревшие файлы блокировки, принадлежащие другому пользователю. Удаление каталога /tmp/firebird работает, но проблема в том, что он будет воссоздан под вашими локальными разрешениями.

macOS

todo: описать это, возможно адаптация Более ранняя версия embedded Firebird на Linux и особенно Firebird Embedded на macOS

Соответствие требованиям SQL

Эта программа имеет возможность в полной мере поддерживать SQL-92 Entry Level. Таким образом доступен любой запрос и появляется возможность пользоваться встроенными функциями. Реализация ограничения проверок в доменных полях реализуется также с помощью этой утилиты.

Необходимо учесть, что скорость и качество памяти имеет непосредственное отношение к производительности. Эта утилита может воспроизводиться многими платформами, которые связаны между собой легкими переходами. Также для работы с сервером не обязательно использовать слишком мощное оборудование.

Какими операционными системами лучше пользоваться

В наше время последние сервера разработаны лишь для 32 и 64-разрядных версий Windows, Linux и MacOS X. Можно легко переходить из одной операционной системы в другую. При этом копируется база данных в одной системе и воспроизводится в другой.

Firebird что это за программа

Firebird (Firebird SQL) — это программа или реляционная система управления базами данных (СУБД), способная работать на ОС Linux, Microsoft Windows, MacOS X, Solaris Sparc, HP-UX, FreeBSD и других разнообразных Unix платформах. Эта программа Firebird не требует постоянного администрирования. Она основана на исходном коде, который был выпущен корпорацией Borland в 2000 году в качестве Interbase 6.0 (свободной версии). Firebird совместима со стандартом SQL’92.

Что это Firebird?

СУБД Firebird является независимым проектом программистов (C и C++), разработчиков систем управления базами данных и технических советников. Используется в самых разнообразных системах как негосударственного, так и государственного секторов. Основными причинами для перехода являются:

• Оригинальные функции Firebird и простота в использовании. Особенно относится к версии MS SQL 6.5, которая работает с devices (фиксированными устройствами), а не с динамически расширяющимися файлами. Это весомое преимущество, поскольку данный вариант способен привести к определенным проблемам при администрировании.
• Дополнительный сервер и хранилище. MS SQL предлагает, и даже рекомендует, пользователям приобрести еще один дополнительный сервер (операционную систему, оборудование или сервер баз данных), чтобы установить его как хранилище данных для генерации всех отчетов.

• Нет привязки к поставщику ПО. MS SQL работает только на Windows NT2000, а значит, что Вы «привязаны» к ОС Microsoft. А вот эта программа Firebird не имеет привязки к какому-либо поставщику программного обеспечения. Система может работать и на Windows, и на множестве других платформах, включая Linux, MacOS X, Solaris и т.д.
• Открытость исходных кодов. Исходные коды Firebird открыты, что позволяет максимально комфортно использовать эту СУБД, вносить изменения и улучшать, находить ошибки. Если Вы хорошо понимаете исходный код, добавление таких функций и повышение гибкости в системе не составит особого труда.
• Отсутствие стоимости. Известно, что это программа Firebird является совершенно бесплатной системой, в то время как за использование сервера MS SQL взимается плата за каждый процессор, собственно на котором он работает.

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

Инструкция по удалению Firebird

1. Удаление через «Панель управления». Чтобы остановить СУБД FireBird 1.5 через «Панель управления», необходимо открыть окно «FireBird Server Control», запустив FireBird 1.5 Server Manager, и выбрать действие «Stop». Подтвердите, нажав «OK».
2. Удаление через «Установку и удаление». Для начала следует открыть «Панель управления», а затем раздел «Установка и удаление программ». В списке выделить программу СУБД FireBird 1.5 и выбрать действие «Удалить» Firebird. Для подтверждения удаления нажать на кнопку «Да». В следующем окне, появившемся после вышеперечисленных действий, выберите «Yes to All» и подтвердите, нажав «ОК». После успешного удаления останется лишь перезагрузить компьютер.

(0 , в среднем: 0 из 5)

Выбор СУБД для мобильного Delphi-приложения

Из песочницы

Данная статья написана по мотивам – мотивам разработки мобильного приложения, недавно вышедшего на платформах iOS и Android. Это событие можно было бы назвать заурядным и мало кому интересным, если бы не одно большое и несколько незначительных «но»: вся разработка (включая сервер) велась на Delphi, а в качестве СУБД, как ни странно, задействована совсем не SQLite. Автор, безусловно, понимает, что на текущий момент уже существуют мобильные Delphi-приложения, включая доступные в официальных магазинах, однако не наблюдает обилия русскоязычных публикаций, призванных, как минимум, предостеречь читателей от ошибок, сделанных разработчиком таких проектов. Написанное же здесь преследует цель помочь тем, кто сейчас выбирает СУБД для своего творения, либо уже остановился на каком-то варианте, но желает убедиться в правильности своего решения.
Прежде чем начать, необходимо дать краткое представление о разработанном приложении – это список покупок, имеющий в своём запасе некоторый уникальный функционал. Если кто-то сам уже пользуется (или пользовался) одним из многочисленных аналогов, то сейчас мог скептически хмыкнуть – мол зачем ещё один, и так есть из чего выбрать, на что можно лишь посоветовать продолжить чтение, чтобы ознакомиться с его принципиальной особенностью.

Что это Firebird?

СУБД Firebird является независимым проектом программистов (C и C++), разработчиков систем управления базами данных и технических советников. Используется в самых разнообразных системах как негосударственного, так и государственного секторов. Основными причинами для перехода являются:

• Оригинальные функции Firebird и простота в использовании. Особенно относится к версии MS SQL 6.5, которая работает с devices (фиксированными устройствами), а не с динамически расширяющимися файлами. Это весомое преимущество, поскольку данный вариант способен привести к определенным проблемам при администрировании.
• Дополнительный сервер и хранилище. MS SQL предлагает, и даже рекомендует, пользователям приобрести еще один дополнительный сервер (операционную систему, оборудование или сервер баз данных), чтобы установить его как хранилище данных для генерации всех отчетов.

• Нет привязки к поставщику ПО. MS SQL работает только на Windows NT2000, а значит, что Вы «привязаны» к ОС Microsoft. А вот эта программа Firebird не имеет привязки к какому-либо поставщику программного обеспечения. Система может работать и на Windows, и на множестве других платформах, включая Linux, MacOS X, Solaris и т.д.
• Открытость исходных кодов. Исходные коды Firebird открыты, что позволяет максимально комфортно использовать эту СУБД, вносить изменения и улучшать, находить ошибки. Если Вы хорошо понимаете исходный код, добавление таких функций и повышение гибкости в системе не составит особого труда.
• Отсутствие стоимости. Известно, что это программа Firebird является совершенно бесплатной системой, в то время как за использование сервера MS SQL взимается плата за каждый процессор, собственно на котором он работает.

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

Создание приложений для СУБД Firebird с использованием различных компонент и драйверов: ADO.NET Entity Framework 6

Tutorial

В данной статье будет описан процесс создания приложений для СУБД Firebird с использованием компонентов доступа Entity Framework и среды Visual Studio 2015. ADO.NET Entity Framework (EF) — объектно-ориентированная технология доступа к данным, является object-relational mapping (ORM) решением для .NET Framework от Microsoft. Предоставляет возможность взаимодействия с объектами как посредством LINQ в виде LINQ to Entities, так и с использованием Entity SQL.
Entity Framework предполагает три возможных способа взаимодействия с базой данных:

• Database first: Entity Framework создаёт набор классов, которые отражают модель конкретной базы данных.
• Model first: сначала разработчик создаёт модель базы данных, по которой затем Entity Framework создаёт реальную базу данных на сервере.
• Code first: разработчик создаёт класс модели данных, которые будут храниться в БД, а затем Entity Framework по этой модели генерирует базу данных и её таблицы

В своём приложении мы будем использовать подход Code First, однако вы без труда сможете использовать и другие подходы.
Наше приложение будет работать с базой данных, модель которой представлена на рисунке ниже.

Внимание!
Эта модель является просто примером. Ваша предметная область может быть сложнее, или полностью другой. Модель, используемая в этой статье, максимально упрощена для того, чтобы не загромождать описание работы с компонентами описанием создания и модификации модели данных.

Модель, используемая в этой статье, максимально упрощена для того, чтобы не загромождать описание работы с компонентами описанием создания и модификации модели данных.

Detailed info

Firebird Maestro is the premier Firebird tool for database management, control and development.
It provides a rich set of GUI tools for anyone who uses Firebird including database developers, DBAs, and data analysts. Key features include:

• Support for all Firebird versions up to 4.0
• Easy database object management

• Database Designer

• Comfortable access to Firebird security features

• Data management and data analysis tools

• Handy SQL Editor with code folding and multi-threading

• Visual Query Builder with support for subqueries and UNIONS

• Data export/import to/from the most popular formats

• Database schema refactoring tools

• Powerful BLOB Viewer/Editor

All these features make our product your irreplaceable assistant in the world of the Firebird database server. Boost your productivity and save your time and efforts on managing and maintaining your databases with Firebird Maestro!

Top 10 reasons to use Firebird Maestro

Latest Firebird versions support Firebird Maestro supports all the latest versions of Firebird server

Powerful security management Firebird security system is easy and at the same time really covenient in Firebird Maestro

Easy database objects management Firebird Maestro is incredibly easy in database objects management

Clear in use Even a newbie can use Firebird Maestro

Advanced SQL Editor Firebird Maestro allows you to create and execute queries in the most convenient way

Powerful data export and import Firebird Maestro provides you with advanced data export and import abilities

Full support for BLOB fields Firebird Maestro has an ability to view BLOB data in various ways

Viewing data as diagrams Firebird Maestro allows you to build diagrams based on Firebird server.

The fastest way for building queries Firebird Maestro allows you to create the SELECT statements visually

Full customization according to your preferences and needs Firebird Maestro admits to flexible customization

Технология хранения и индексирования

Multi-Generational Architecture (MGA)

Firebird унаследовала архитектуру хранения Interbase. Для обеспечения ACID-свойств транзакций, механизм работы базы данных хранит различные версии каждой записи, изменённой активными пользователями в базе данных. После завершения транзакции, последняя версия каждой измененной записи помечается как окончательная. В случае отката транзакции, базы данных оставляет отметку на оригинальной версии записи, оставляя данные нетронутыми. В результате этого, количество записей на диск с использованием Firebird сильно уменьшено по сравнению с базами данных, использующими традиционную архитектуру журнала транзакций. Запись транзакций не препятствует чтению и наоборот, потому что каждый пользователь видит свою собственную версию базы данных. Компромисс заключается в том, время от времени требуется удаление старых версий записей и для освобождения дискового пространства.

Multi-Generational Architecture (архитектура с несколькими поколениями) обеспечивает одновременное выполнение операций OLTP и DSS / OLAP без задержек, которые вызывают механизмы блокировки, используемые в других продуктах.

Индексы

В Firebird все индексы базы данных ведут себя как хорошо настроенные «кластерные индексы», используемые другими архитектурами. Индексы Firebird не являются объектами двухфазной блокировки, в следствие чего логические операции «и» и «или» могут выполняться на промежуточных этапах с незначительной стоимостью, исключая необходимость выбора оптимизатором альтернативных индексов.

Что за программа Firebird

В нашем случае речь идёт о полностью бесплатном приложении для управления базами данных. При этом она кроссплатформенная. То есть её возможно использовать как для Windows, так и для Mac. Именно по такой причине многими разработчиками коммерческих продуктов используется эта программа. Примером может стать утилиты или программные продукты типа клиентов банков или 1С. Если вы пожелаете удалить рассматриваемое приложение, то такие сервисы вам могут быть уже недоступны.

Основными особенностями этого приложения являются:

Этим приложением сегодня пользуются на бесплатной основе. Как для коммерческого использования, так и для других целей. На жёстком диске вам не потребуется много места для него. При этом у приложения есть возможность работать с достаточно большими базами данных. Вокруг Фаербёрда собралось очень много энтузиастов, которые дают возможность другим пользователям владеть актуальной информацией.

Необходимо рассказать и о других преимуществах такого типа СУБД:

Подводя итог, можно говорить о том, что эта бесплатная программа с открытым кодом даёт возможности для всех желающих получить возможность работать с базами данных. Так что деинсталлировать это приложение не стоит.

Подобных спорных процессов и программ может быть более сотни, поэтому используйте Диспетчер Задач, чтобы, во-первых, увидеть запущенные задачи, а во-вторых, удалить те, которые вам не нужны.

Характеристики и возможности

Разберем подробнее, на что способна программа.

Основные особенности:

Открытый код	Программу можно использовать бесплатно как для приложений с открытым кодом, так и для коммерческих целей.
Малый вес	Firebird не занимает много места на жестком диске. При этом, она работает с базами в сотни раз превышающими ее размер.
Распространенность	Firebird собрала вокруг себя сообщество энтузиастов. В любой момент пользователи получают актуальную информацию о ее работе.
Построение баз данных в режиме «только для чтения»	СУБД может распространять данные на съемных носителях.
Копирование «на лету»	При резервном копировании не нужно останавливать работу сервера. Технология копирования предполагает сохранение базы в момент создания копии. Процесс не мешает работе сервера.

Преимущества СУБД:

• софт совместим со всеми актуальными ОС;
• не требует настройки и отладки. Запускается непосредственно после установки;
• работает в автоматическом режиме;
• расширение функций за счет внешнего функционала;
• установщик не занимает много места;
• поддерживаются хранимые процедуры и триггеры;
• записи различных версий обрабатываются параллельно с остальными;
• триггеры создаются на SQL;
• нет необходимости в участии системных администраторов;
• поддержка широкого набора языков кодировки.

Не обошлось без минусов. Среди основных такие:

1. Отсутствует кэш. Не отслеживается история запросов.
2. Замедление работы с увеличением внутренней фрагментации базы.

Версии сервера

Релиз Firebird 1.0 — это первая версия (ноябрь 2001 года), базирующаяся на открытых исходных текстах InterBase 6.0. Поэтому в основном релиз содержит большое число исправлений ошибок IB 6.0.

• Расширенные проверки зависимостей (udf и генераторы)
• Убраны проблемы с размером файла БД более 4 гигабайт (кроме FAT16 и FAT32, где файл не может быть больше 2-4 гигабайт)
• Поддержка размера страницы БД 16 килобайт
• ForcedWrites теперь ON по умолчанию при создании БД
• Параметр конфигурации для задания расположения внешних файлов
• Увеличено количество внешних файлов, открываемых одновременно
• Внешний файл закрывается, если внешняя таблица удаляется
• Добавлен параметр CPU_Affinity (Superserver)
• Возможность указания номера порта в строке коннекта
• параметр NONAGLE для Linux
• расширения isc_info_database
• счетчик записей для gbak (при указании опции -v)
• переменные CURRENT_USER и CURRENT_ROLE
• команда DROP GENERATOR
• возможность группировки по UDF (group by <function>)
• команда RECREATE PROCEDURE
• команда RECREATE TABLE
• опции SELECT FIRST (<int>) SKIP (int) …
• функция SUBSTRING(<str> FROM <pos> )
• команда PLANONLY для ISQL
• новый маркер комментариев —
• расширения ib_udf (SUBSTR, SUBSTRLEN, ASCII_CHAR)
• новый набор функций FBUDF.DLL
• by descriptor в параметрах UDF

Запуск набора тестов базы данных FPC

Может быть полезно запускать среду тестирования базы данных FPC (в каталоге packages\fcl-db\tests), когда вы охотитесь за ошибками, пытаетесь выяснить, как что-то работает или улучшаете код базы данных.

Сообщаем платформе, какую базу данных использовать

Вам нужно будет отредактировать INI-файл db test framework, чтобы сообщить исполняемому файлу теста, что ему нужно использовать вашу встроенную базу данных.
См. для получения инструкций о том, как это сделать.

Создание тестовой базы данных

Если вы настроили среду для использования Firebird, вам нужно будет подготовить среду для тестирования.

Скопируйте библиотеки embedded Firebird и другие файлы для вашей архитектуры в тестовый каталог.

Затем создайте тестовую базу данных — вручную или программно/

Создание базы данных вручную

isql

create database 'test.fdb' user 'SYSDBA' password 'masterkey' page_size 16384 default character set UTF8;
exit;

Программное создание базы данных

Вы можете программно создать базу данных. В приведенном ниже примере создается локальная встроенная база данных, но ее можно легко изменить на удаленную базу данных (измените имя хоста и, если необходимо, путь):

program firebirdembeddedtest;
{$mode objfpc}{$H+}

uses 
  {$IFDEF UNIX}{$IFDEF UseCThreads}
  cthreads,
  {$ENDIF}{$ENDIF} 
  Classes, SysUtils,
  sqldb, IBConnection {for Firebird};

const
  // Имя для базы данных. Обязательно укажите одно и то же имя в вашем database.ini
  DatabaseFile = 'test.fdb'; //Разумное имя для тестовой базы данных, верно?
var
  Fire TIBConnection;

begin
  //Подключение к базе данных Firebird
  //Следующая строка нужна для довольно старых версий FPC
  //UseEmbeddedFirebird: = true; 
  //Более новые версии сначала будут искать файл fbembed.dll в каталоге приложения автоматически 
  //Использование встроенного (и fbembed.dll) или обычного клиент/сервера (fbclient.dll) требует использования ibase60dyn
  Fire:=TIBConnection.Create(nil);
  try
    Fire.HostName := ''; //должен быть пустым для embedded Firebird; должен быть заполнен для клиент/сервера Firebird
    Fire.DatabaseName := DatabaseFile; //(путь и ) имя файла
    // Имя пользователя и пароль не имеют значения для аутентификации, но вы получаете авторизацию в базе данных    
    // на основе имени (и, возможно, роли), которое вы даете.
    Fire.Username := 'SYSDBA';
    Fire.Password := 'masterkey'; //пароль для SYSDBA по умолчанию
    Fire.Charset := 'UTF8'; //Отправка и получение строковых данных в кодировке UTF8
    Fire.Dialect := 3; //Никто больше не использует диалекты 1 или 2 (прим.перев.: это справедливо лишь в отношении новых проектов)
    Fire.Params.Add('PAGE_SIZE=16384'); //Мне нравится большой размер страницы (используется при создании базы данных). Полезно для больших индексов ⇒ больший возможный размер столбца
    // Выясните, есть ли база данных в каталоге приложения. 
    // Если нет, создайте его. Примечание: это может не сработать, если у вас недостаточно прав.

    // Если вы используете клиент / сервер, вам явно не нужна эта часть кода.
    if (not FileExists(DatabaseFile)) then
    begin
        writeln('Файл '+DatabaseFile+' не существует.');
        writeln('Создание базы данных Firebird embedded ...');
        // Создаем базу данных, поскольку она не существует
        try
          Fire.CreateDB; //Создаем файл базы данных.
        except
          on E Exception do
          begin
            writeln('ОШИБКА при создании базы данных. Возможно проблемы с загрузкой встроенной библиотеки:');
            writeln('- не все файлы присутствуют');
            writeln('- неправильная архитектура (например, 32 бит вместо 64 бит)');
            writeln('Exception message:');
            writeln(E.ClassName+'/'+E.Message);
          end;
        end;
        Fire.Close;
    end;
  finally
    Fire.Free;
  end; 
end.

Наконец, скомпилируйте и запустите dbtestframework.pas программы тестирования базы данных. Он должен генерировать вывод состояния на консоли и вывод XML в файлах с результатами теста, которые можно проанализировать и отправить разработчикам.