ЛИНТЕР

Начать оперативное архивирование

Функция

Определение оператора запуска процесса архивирования БД в оперативном режиме.

Спецификация

<начать архивирование>::=
  BACKUP DATABASE [[START | STOP] INCREMENT]
  [DEVICE <имя устройства>]
  [FILE <спецификация файла> [REWRITE]]
  [COMMENT <комментарий>]
  [PASSWORD <пароль>]
  [VOLUMES <размер тома> [K|M]]
  [ASYNC];

<имя устройства>::= 4-х символьный литерал
<спецификация файла>::= символьный литерал
<размер тома>::= целочисленный литерал

Синтаксические правила

Опция DATABASE задает полное сохранение БД без возможности нарастающего архивирования;
<спецификация файла> задает полную спецификацию (устройство, путь к каталогу и имя) архивного файла. Если тип файла не указан, по умолчанию используется .lhb.

Пример для ОС типа Linux, ЗОСРВ Нейтрино:
```
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 (пункт «Мониторинг процессов асинхронного архивирования»).