Инструкция по миграции на Firebird 5.

[TechAnton]

Инструкция разделена на этапы, которые необходимо выполнять последовательно.

Подготовительные действия

1. Сделать резервную копию базы данных на текущем сервере Firebird.
2. Сделать резервную копию файла firebird.conf из папки текущей версии Firebird.

Установка Firebird

1. Отключить все активные службы Firebird
2. Удалить старые версии Firebird с компьютера
3. Скачать выполняемый (exe) файл с оффициального сайта Firebird: https://www.firebirdsql.org/en/firebird-5-0
4. Выполнить установку. Особых условий к установке нет, но рекомендуется выбрать:

• тип сервера: Classic

• не запускать сервер по окончанию установки:

5. Открыть папку, в которую была установлена новая версия Firebird. По умолчанию: C:\Program Files\Firebird\Firebird_5_0
6. Создать новую папку "UDF". По умолчанию путь до нее будет: C:\Program Files\Firebird\Firebird_5_0\UDF
7. Cкопировать библиотеку gudf.dll в папку "UDF". (Библиотеку gudf.dll можно скачать с официального сайта Гедымин)

Настройка Firebird

1. Открыть файл firebird.conf.

2. Добавить в firebird.conf следующие настройки:

AuthServer = Srp256, Srp, Legacy_Auth
UserManager = Legacy_UserManager, Srp 
WireCrypt = Enabled
UdfAccess = Restrict UDF
DataTypeCompatibility = 2.5
ServerMode = Classic
MaxParallelWorkers = 4
ParallelWorkers = 1
OuterJoinConversion = false

Дополнительные настройки (необязательные, для опытных пользователей):

DefaultTimeZone = Europe/Moscow #Устанавливает временную зону для работы с временем (по умолчанию устанавливает настройки системы)
RemoteServicePort = 3055 #Задает порт, на котором будет работать Firebird (по умолчанию 3050)

3. Сохранить файл firebird.conf.
   Если у Вас возникла проблема с доступом (ошибка чтения/записи), то есть 3 способа решения этой проблемы:

   • открыть файл от имени Администратора
   • предоставить на этот файл права на полный доступ для текущего пользователя
   • переместить файл в другую папку (или на рабочий стол), произвести необходимые действия, сохранить, скопировать с заменой в исходную папку

4. Запустить сервер Firebird:

   • Диспетчер задач ➝ Службы ➝ Найти службу FirebirdServerDefaultInstance ➝ Правый клик мыши по этой службе ➝ Запустить
   • Выполнить команду instsvc start в командной строке

Восстановление базы данных

1. Открыть программу Гедымин
2. Выполнить стандартное восстановление базы данных из резервной копии
3. Протестировать работу

Потенциальные проблемы и их решение

1. В процессе восстановления базы данных возможно будут сообщения данного содержания:

gbak: WARNING: function <function_name> is not defined.

Например:

Если Вы заметили такие сообщения при восстановлении своей базы данных, то необходимо:
1.1) Cкачать специальную утилиту с сайта Гедымин для удаления зависимостей от встроенных функций Firebird
1.2) Открыть утилиту
1.3) Заполнить необходимые данные
1.4) Нажать кнопку "Пуск"

Пример работы утилиты:

2. Поле "Количество потоков" при восстановлении базы данных заблокировано. Необходимо:
   2.1) Cкачать Firebird в ZIP формате для windows 32 бит (это архитектура x86)
   2.2) Скопировать с заменой все DLL файлы в папку программы.
   Чтобы избежать конфликта версий, рекомендуется удалить старые версии этих файлов из программы.
   Например: при копировании файла icudt63.dll удалить файл icudt30.dll из папки программы.

Установка второго сервера Firebird на один компьютер

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

1. Выполнить все действия из блока "Установка Firebird", кроме удаления старых версий Firebird
2. Скачать Firebird в ZIP формате
3. Чтобы избежать запретов на копирование и изменение файлов, произвольного удаления файлов, ожидание проверок и так далее, рекомендуется отключать антивирус!
4. Скопировать с заменой все файлы из архива в папку, в которую был установлен Firebird
5. Открыть консоль. Перейти в папку Firebird командой:

cd <путь до файла> 

Пример:

cd C:\Program Files\Firebird\Firebird_5_0

6. Создать пользователя SYSDBA

isql security.db -user SYSDBA

CREATE USER SYSDBA PASSWORD 'masterkey';

exit;

Пример результата работы:

7. Произвести манипуляции с файлов firebird.conf, указанные в блоке "Настройка Firebird"
8. Выполнить команды по запуску сервера:

#Установить сервер
instsvc install -n fb50

#Запустить сервер
instsvc start -n fb50

Дополнительные команды, которые могут пригодится:

#Остановить сервер
instsvc stop -n fb50

#Удалить сервер
instsvc remove -n fb50

#Просмотреть список всех запущенных серверов
instsvc query

Пример запуска сервера:

9. Включить антивирус

[TechAnton]

Текущий финальный принцип работы архивации

1. Желательно удалить неактуальные количественные показатели. Это делается на отдельной форме.

---- Подготовка к архивации ----

2. Отключение триггеров
3. Отключение простых индексов на таблицах AC_RECORD и AC_QUANTITY. Внешние ключи и их индексы не отключаются

---- Суммирование проводок ----

4. В таблице AC_ENTRY создаются поля на каждый вид количественных показателей
5. Данные из таблицы AC_QUANTITY переносятся в новые созданные поля в таблице AC_ENTRY
6. Запускается цикл для сжатия данных:
   6.1) Из таблицы AC_ENTRY выбираются все связки COMPANYKEY + CURRKEY
   6.2) На каждую связку COMPANYKEY + CURRKEY создается документ
   6.3) Запускается цикл по всем счетам, которые имели хотя бы 1 проводку для связки COMPANYKEY + CURRKEY
   6.4) На каждый счет в этом цикле достаются его активные аналитики из БД + аналитика GS_DOCUMENT, если она указана для этого счета.
   6.5) На основании всех этих аналитик формируется SQL-запрос для сжатия. Работает по принципу:

FOR SELECT SUM(IIF(E.ACCOUNTPART = ''D'', E.DEBITNCU, E.CREDITNCU * -1)) -- и так для всех видов сумм
FROM AC_ENTRY
WHERE ACCOUNTKEY = :ACCOUNTKEY
      AND CURRKEY = :CURRKEY
      AND COMPANYKEY = :COMPANYKEY
      AND ENTRYDATE < :ARCHIVE_DATE
GROUP BY <все аналитики по счету>
INTO --
DO
BEGIN
   INSERT INTO AC_RECORD...
   INSERT INTO AC_ENTRY...
   INSERT INTO AC_QUANTITY...
END

7. Из AC_ENTRY удаляются все поля, созданные для хранения количественных показателей

---- Удаление старых проводок ----

8. Берется таблица AC_RECORD и все таблицы, которые имеют к ней внешние ключи с каскадным удалением
9. На каждую таблицу создается её резервная версия с префиксом "BACK$" и создаются триггеры на AFTER DELETE, которые делают INSERT INTO удаленной записи в резервную таблицу
10. Удаляются все старые записи из таблицы AC_ENTRY
11. Удаляются все старые записи из таблицы AC_RECORD
12. Удаляются триггеры из пункта 9

---- Восстановление изначальной БД после архивации ----

12. Включение триггеров
13. Включение всех простых индексов на таблицах AC_RECORD и AC_QUANTITY

---- Следует выполнить вручную ----

14. Сделать резервную копию БД (обязательно отключить сборщик мусора)
15. Восстановить БД
16. Протестировать

Результаты архивации

Результаты представлены для архивации проводок до 2016 года. Без учета аналитики GS_DOCUMENT.

Время архивации

[TechAnton]

Результаты архивации проводок

Для тестирования было выбрана БД Бройлеров от 24.06.2025. Устаревшие количественные показатели были удалены.

Аналитика GS_DOCUMENT использовалась только для счетов 18.1.* (18.1.1, 18.1.2, 18.1.11...).

Результаты архивации

№ п.п.	Год архивации	Время архивации, чч:мм	Количество записей AC_ENTRY	Количество записей AC_RECORD	Размер AC_ENTRY, Гбайт	Размер AC_RECORD, Гбайт	Общий размер БД, Гбайт
1	Без архивации	-	306 116 196	151 622 510	131,3	24,2	392,8
2	До 2016	03:07	229 566 165	113 846 807	98,8	18,5	370,7
3	С 2016 до 2020	04:05	146 278 748	72 586 891	63,0	11,9	346,6
4	Сразу до 2020	05:37

Разбивка времени на архивацию

До 01.01.2016

(чч:мм)
00:46 -- перенос данных из AC_QUANTITY в AC_ENTRY
00:25 -- создание новых (итоговых) проводок
00:56 -- удаление записей из AC_ENTRY
01:00 -- удаление записей из AC_RECORD

03:07 -- общее время выполнения

С 2016 года до 01.01.2020

(чч:мм)
00:59 -- перенос данных из AC_QUANTITY в AC_ENTRY
00:44 -- создание новых (итоговых) проводок
01:05 -- удаление записей из AC_ENTRY
01:17 -- удаление записей из AC_RECORD

04:05 -- общее время выполнения

Сразу до 01.01.2020

(чч:мм)
00:50 -- перенос данных из AC_QUANTITY в AC_ENTRY
00:49 -- сжатие проводок и создание новых проводок
02:10 -- удаление записей из AC_ENTRY
01:48 -- удаление записей из AC_RECORD

05:37 -- общее время выполнения

[TechAnton]