Руководство пользователя altAwin:Обновление базы данных
Обновление базы данных
Обновление базы с использованием утилиты DBUpdate
Обновление БД заключается в обновлении схемы БД (то есть объектов БД, таких как таблицы, поля таблиц, представления, процедуры и т. д.) и, при необходимости, в обновлении самих данных.
В версии altAwin 2.5.6 была произведена замена ранее использовавшейся для обновления утилиты Database Schema Update, а также усовершенствован механизм обновления базы данных. Утилита обновления базы данных Database Schema Update была исключена из комплекта поставки приложения, начиная с версии altAwin 2.6.6. В современных версиях для обновления базы данных применяется утилита FirebirdDBUpdate.exe.
В том случае если при запуске altAWin обнаруживается, что БД устарела и требуется её обновление, при попытке входа в программу под учётной записью администратора (а в версии AW Dealer Start для любого пользователя) производится запуск утилиты обновления базы данных (..\Bin\FirebirdDBUpdate.exe), с параметрами, соответствующими текущей подключенной базе. После успешного обновления и закрытия утилиты, производится автоматический перезапуск altAwin.
Утилита для обновления БД может работать только на том компьютере, на котором установлена серверная часть Firebird Database Server 2.1 и БД! |
При обновлении базы данных все пользователи обязаны выйти из программы! |
Обновление схемы БД может осуществляться только в прямом направлении: схемы БД старых версий заменяются только на схемы новых версий (например, БД версии 2.6 не может быть замещена на БД версии 2.4). |
В окне утилиты обновления базы данных помимо указания режима работы можно определить способ обращения с таблицами прав доступа и изменить мастер-логин. (см. Руководство по настройке altAwin:Создание и настройка конфигураций)
В открывшемся окне утилиты обновления требуется сделать следующее:
- 1) выберете режим работы:
- создание БД - для создания новой базы данных.
- обновление БД - для обновления базы данных.
- пересоздание БД - для обновления базы данных с последующим экспортом данных, созданием новой БД и импортом данных в неё. Данный сценарий обновления позволяет избежать системных ошибок, появление которых возможно при частом обновлении одного и того же файла базы данных. Процесс пересоздания файла БД занимает больше времени, чем процесс обновления уже существующего файла. Поэтому запускать этот процесс рекомендуется в том случае, если необходимо пересоздать базу данных, которая ранее уже многократно подвергалась обновлению (~ более 10 раз).
- 2) в поле Файл БД: введите посредством обозревателя файлов имя файла БД для обновления;
- 3) в поле Пароль SYSDBA: введите пароль администратора БД;
- 4) при необходимости назначьте новый мастер-логин и укажите параметры распределения разрешений.
При нажатии на кнопку OK будет запущен процесс обновления.
Появится окно Список скриптов, отображающее разделённые на группы названия файлов скриптов, которые будут выполняться в процессе обновления БД, а также путь к этим файлам (см. рис. 4.10). Файлы скриптов содержат команды SQL, изменяющие схему БД или данные в таблицах.
При обновлении базы данных версии altAwin 1.4 скрипты выполняются последовательно в следующем порядке:
- обновление текущей версии базы данных до последней версии 1.4;
- конвертирование базы данных последней версии 1.4 до первой версии 2.0;
- обновление первой версии 2.0 до текущей версии 2.x;
Чтобы запустить процесс обновления, нажмите на кнопку Запуск в окне Настройки. Появится окно Выполнение скриптов (см. рис. 4.11), в котором отображается информация о процессе обновления.
В следующем и последнем окне Завершено (см. рис. 4.12) расположен флажок Сохранить установленные параметры в файл настроек. При установке этого флажка вся информация о настройках (см. рис. 4.10) записывается в *.ini-файл, расположенный в каталоге установки программы Database schema update и может быть использована при последующих обновлениях базы данных.
Флаг Сохранить лог в файл позволяет сохранить все сообщения в файл.
Автоматическое обновление БД
После обновления программы altAwin на новую версию при запуске программы производится проверка текущей версии базы данных на соответствие версии программы. Если версия базы данных отличается от необходимой для работы приложения, а в каталоге Scripts обнаружены требуемые скрипты обновления, то при входе в программу под учётной записью администратора, пользователю предлагается автоматически выполнить обновление базы до новой версии. Отображается диалоговое окно с вопросом, следует ли выполнить предлагаемое обновление (см. рис. 4.13). После нажатия на кнопку OK в открывшемся новом диалоговом окне введите пароль администратора базы данных (рис. 4.14). При нажатии на кнопку Игнорировать работа будет продолжена без обновления базы данных.
Будет запущено процесс выполнения скриптов обновления.
При отрицательном ответе будет выведено стандартное сообщение об ошибке, связанной с устаревшей версией базы данных. Обновление базы также может быть выполнено вручную средствами дополнительной утилиты SchemaUpdate.exe, входящей в комплект поставки программы.
- Параметры командной строки утилиты FirebirdDBUpdate.exe
Утилита обновления базы данных может быть запущена вручную со следующими параметрами командной строки:
- dbname — путь к БД
- sysdbapass — пароль SYSDBA; только для полной версии
- mode — режим работы утилиты — create|update|recreate
- autostart — автозапуск обновления без отображения окна подтверждения начала выполнения операций
- runapp — путь к приложению, которое необходимо запустить после окончания работы утилиты
- runappparams — параметры командной строки для приложения, запускаемого после окончания работы утилиты.
Пример:
- FirebirdDBUpdate.exe -dbname: altawin.gdb -mode: create