Начать оперативное архивирование
Функция
Определение оператора запуска процесса архивирования БД в оперативном режиме.
Спецификация
< начать архивирование >::= BACKUP DATABASE [[START | STOP] INCREMENT] [DEVICE < имя устройства >] [FILE < спецификация файла > [REWRITE]] [COMMENT < комментарий >] [PASSWORD < пароль >] [VOLUMES < размер тома > [K|M]] [ASYNC]; < имя устройства >::= 4-х символьный литерал < спецификация файла >::= символьный литерал < размер тома >::= целочисленный литерал
Синтаксические правила
-
Опция
DATABASE
задает полное сохранение БД без возможности нарастающего архивирования; -
< спецификация файла > задает полную спецификацию (устройство, путь к каталогу и имя) архивного файла. Если тип файла не указан, по умолчанию используется
.lhb
.Пример для UNIX-платформ:
BACKUP DATABASE FILE 'SY00/ARCHIVES/database.lhb'; BACKUP DATABASE FILE '/../db.lhb';
-
Фраза
REWRITE
разрешает удалять существующий архивный файл и создавать новый с тем же именем; -
Конструкция
DATABASE START INCREMENT
задает полное сохранение БД с возможностью нарастающего архивирования; -
Конструкция
DATABASE INCREMENT
– сохранение всех изменений в БД со времени последнего нарастающего сохранения (от последней контрольной точки, созданной, например, с помощьюDATABASE START INCREMENT
); -
Конструкция
DATABASE STOP INCREMENT
прекращает ведение нарастающего архивирования: последняя контрольная точка удаляется, а архивный файл закрывается. Т.к. по этому SQL-запросу сохранение в архивном файле последней порции накопленных в БД изменений (т. е. начиная с последней контрольной точки) не осуществляется, то перед его выполнением необходимо подать SQL-запросBACKUP DATABASE INCREMENT
для исключения потери архивных данных; -
Опция
DEVICE
задает логическое имя устройства, на котором должен создаваться файл архива. Устройство должно быть описано в системной таблице $$$DEVICE. Если имя устройства не задано, по умолчанию используется переменная окруженияSY00
. ЕслиSY00
не определена, архив создается в каталоге запуска ядра СУБД ЛИНТЕР.Пример:
BACKUP DATABASE DEVICE 'SY02' FILE 'h:\linter\arhiv\sale2804.lhb';
-
< комментарий > задает текст комментария к архивному файлу;
-
< пароль > задает пароль архивного файла;
-
Конструкция
VOLUMES < размер тома > [K|M]
разрешает разбивать архивный файл на отдельные тома указанного < размера тома >:К
– в Кбайтах,M
– Мбайтах; -
Опция
ASYNC
задает асинхронное выполнение процесса архивирования.
Общие правила
Примечания
-
По возможности использовать для архивирования БД утилиту lhb, а не SQL-запрос
BACKUP DATABASE
. -
Не использовать для архивирования БД SQL-запрос
BACKUP DATABASE
, если в БД есть фразовые индексы.
Если задана опция ASYNC
, пользователю сразу будет возвращен код завершения, указывающий на результат выполнения SQL-запроса (успешный или неуспешный запуск процесса архивирования). В дальнейшем информацию о текущем состоянии процесса архивирования можно будет получать из системной таблицы $$$INKERNBACK (пункт «Мониторинг процессов асинхронного архивирования»).