Переход с Yaffil на Firebird 2.0.x

Версия 20:09, 5 августа 2009

Основная проблема при миграции базы с сервера Yaffil на Firebird 2.0.х -- это отсутствие в последнем встроенных функций BIN_AND и BIN_OR, широко используемых в триггерах и хранимых процедурах базы данных Гедымина.

Для перехода в ручном режиме вам понадобится свежая установка сервера Firebird 2.0.x и утилита IBExpert.

Последовательность действий:

1. На всякий случай архивируем существующую БД.
2. Деинсталируем Yaffil. Не забываем сохранить gudf.dll из подкаталога udf основного каталога размещения сервера Yaffil.
3. Устанавливаем и запускаем сервер Firebird 2.0.5 (последняя доступная версия на момент написания статьи).
4. Копируем библиотеку gudf.dll в подкаталог udf сервера Firebird.
5. Устанавливаем IBExpert (если он еще не был установлен)
6. Подключаемся к существующей базе с помощью IBExpert
7. Регистрируем внешние функции с помощью команд:

DECLARE EXTERNAL FUNCTION bin_and
INTEGER, INTEGER
RETURNS INTEGER BY VALUE
ENTRY_POINT 'IB_UDF_bin_and' MODULE_NAME 'ib_udf'

DECLARE EXTERNAL FUNCTION bin_or
INTEGER, INTEGER
RETURNS INTEGER BY VALUE
ENTRY_POINT 'IB_UDF_bin_or' MODULE_NAME 'ib_udf' 

1. Не забываем делать COMMIT после каждой команды.
2. В дереве объектов базы данных, используя меню по правой нопке мыши, выполняем команды Перекомпилировать процедуры и Перекомпилировать триггеры.
3. Если в процессе перекомпиляции позникают ошибки, то вносим исправления в исходный код с помощью команд ALTER TRIGGER или ALTER PROCEDURE и повторно запускаем перекомпиляцию. Если вы не знаете как исправить ошибочный код триггера или процедуры, то временно можно закоментировать все команды между первым BEGIN и последним END. После окончания процесса миграции не забудьте вернуться, раскоментировать код и исправить все ошибки.
4. Делаем архивную копию и восстанавливаем базу из архива. ВНИМАНИЕ! При восстановлении БД с установленным флагом Commit after each table могут возникать ошибки. В этом случае следует снять указанный флаг и повторить процедуру восстановления базы из архивной копии.

С серверной частью все. Остается на клиентских машинах:

1. Найти все файлы gds32.dll и удалить их.
2. С сервера, из подкаталога BIN основного каталога сервера Firebird берем gds32.dll и выкладываем рядом с gedemin.exe.

Запускаем. Проверяем работу.