Руководство пользователя altAwin:Обновление базы данных

Материал из AltecDocs
Перейти к:навигация, поиск

Обновление базы данных

Обновление базы с использованием утилиты DBUpdate

Обновление БД заключается в обновлении схемы БД (то есть объектов БД, таких как таблицы, поля таблиц, представления, процедуры и т. д.) и, при необходимости, в обновлении самих данных.

В версии altAwin 2.5.6 была произведена замена ранее использовавшейся для обновления утилиты Database Schema Update, а также усовершенствован механизм обновления базы данных. Утилита обновления базы данных Database Schema Update была исключена из комплекта поставки приложения, начиная с версии altAwin 2.6.6. В современных версиях для обновления базы данных применяется утилита FirebirdDBUpdate.exe.

Рис. 4.7. Утилита создания/обновления БД.


В том случае если при запуске altAWin обнаруживается, что БД устарела и требуется её обновление, при попытке входа в программу под учётной записью администратора (а в версии AW Dealer Start для любого пользователя) производится запуск утилиты обновления базы данных (..\Bin\FirebirdDBUpdate.exe), с параметрами, соответствующими текущей подключенной базе. После успешного обновления и закрытия утилиты, производится автоматический перезапуск altAwin.

IconWarning.png Утилита для обновления БД может работать только на том компьютере, на котором установлена серверная часть Firebird Database Server 2.1 и БД!
IconWarning.png При обновлении базы данных все пользователи обязаны выйти из программы!
IconWarning.png Обновление схемы БД может осуществляться только в прямом направлении: схемы БД старых версий заменяются только на схемы новых версий (например, БД версии 2.6 не может быть замещена на БД версии 2.4).
Рис. 4.8. Ошибка подключения к базе данных.


Рис. 4.9. Подтверждение обновления базы данных.


В окне утилиты обновления базы данных помимо указания режима работы можно определить способ обращения с таблицами прав доступа и изменить мастер-логин. (см. Руководство по настройке altAwin:Создание и настройка конфигураций)

В открывшемся окне утилиты обновления требуется сделать следующее:

1) выберете режим работы:
  • создание БД - для создания новой базы данных.
  • обновление БД - для обновления базы данных.
  • пересоздание БД - для обновления базы данных с последующим экспортом данных, созданием новой БД и импортом данных в неё. Данный сценарий обновления позволяет избежать системных ошибок, появление которых возможно при частом обновлении одного и того же файла базы данных. Процесс пересоздания файла БД занимает больше времени, чем процесс обновления уже существующего файла. Поэтому запускать этот процесс рекомендуется в том случае, если необходимо пересоздать базу данных, которая ранее уже многократно подвергалась обновлению (~ более 10 раз).
2) в поле Файл БД: введите посредством обозревателя файлов имя файла БД для обновления;
3) в поле Пароль SYSDBA: введите пароль администратора БД;
4) при необходимости назначьте новый мастер-логин и укажите параметры распределения разрешений.

При нажатии на кнопку OK будет запущен процесс обновления.

Появится окно Список скриптов, отображающее разделённые на группы названия файлов скриптов, которые будут выполняться в процессе обновления БД, а также путь к этим файлам (см. рис. 4.10). Файлы скриптов содержат команды SQL, изменяющие схему БД или данные в таблицах.

При обновлении базы данных версии altAwin 1.4 скрипты выполняются последовательно в следующем порядке:

  1. обновление текущей версии базы данных до последней версии 1.4;
  2. конвертирование базы данных последней версии 1.4 до первой версии 2.0;
  3. обновление первой версии 2.0 до текущей версии 2.x;
Рис. 4.10. Окно Список скриптов


Чтобы запустить процесс обновления, нажмите на кнопку Запуск в окне Настройки. Появится окно Выполнение скриптов (см. рис. 4.11), в котором отображается информация о процессе обновления.

Рис. 4.11. Окно Выполнение скриптов


В следующем и последнем окне Завершено (см. рис. 4.12) расположен флажок Сохранить установленные параметры в файл настроек. При установке этого флажка вся информация о настройках (см. рис. 4.10) записывается в *.ini-файл, расположенный в каталоге установки программы Database schema update и может быть использована при последующих обновлениях базы данных.

Флаг Сохранить лог в файл позволяет сохранить все сообщения в файл.

Рис. 4.12. Окно Завершено


Автоматическое обновление БД

Рис. 4.13. Автоматическое обновление БД


После обновления программы altAwin на новую версию при запуске программы производится проверка текущей версии базы данных на соответствие версии программы. Если версия базы данных отличается от необходимой для работы приложения, а в каталоге Scripts обнаружены требуемые скрипты обновления, то при входе в программу под учётной записью администратора, пользователю предлагается автоматически выполнить обновление базы до новой версии. Отображается диалоговое окно с вопросом, следует ли выполнить предлагаемое обновление (см. рис. 4.13). После нажатия на кнопку OK в открывшемся новом диалоговом окне введите пароль администратора базы данных (рис. 4.14). При нажатии на кнопку Игнорировать работа будет продолжена без обновления базы данных.

Рис. 4.14. Ввод параметров подключения к БД при обновлении


Будет запущено процесс выполнения скриптов обновления.

Рис. 4.15. Выполнение скриптов автоматического обновления


При отрицательном ответе будет выведено стандартное сообщение об ошибке, связанной с устаревшей версией базы данных. Обновление базы также может быть выполнено вручную средствами дополнительной утилиты SchemaUpdate.exe, входящей в комплект поставки программы.

Параметры командной строки утилиты FirebirdDBUpdate.exe

Утилита обновления базы данных может быть запущена вручную со следующими параметрами командной строки:

  • dbname — путь к БД
  • sysdbapass — пароль SYSDBA; только для полной версии
  • mode — режим работы утилиты — create|update|recreate
  • autostart — автозапуск обновления без отображения окна подтверждения начала выполнения операций
  • runapp — путь к приложению, которое необходимо запустить после окончания работы утилиты
  • runappparams — параметры командной строки для приложения, запускаемого после окончания работы утилиты.

Пример:

FirebirdDBUpdate.exe -dbname: altawin.gdb -mode: create