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

Функция

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

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

< имя устройства >::= 4-х символьный литерал
< спецификация файла >::= символьный литерал
< размер тома >::= целочисленный литерал
Синтаксические правила
  1. Опция DATABASE задает полное сохранение БД без возможности нарастающего архивирования;

  2. < спецификация файла > задает полную спецификацию (устройство, путь к каталогу и имя) архивного файла. Если тип файла не указан, по умолчанию используется .lhb.

    Пример для UNIX-платформ:

    BACKUP DATABASE FILE 'SY00/ARCHIVES/database.lhb';
    BACKUP DATABASE FILE '/../db.lhb';
  3. Фраза REWRITE разрешает удалять существующий архивный файл и создавать новый с тем же именем;

  4. Конструкция DATABASE START INCREMENT задает полное сохранение БД с возможностью нарастающего архивирования;

  5. Конструкция DATABASE INCREMENT – сохранение всех изменений в БД со времени последнего нарастающего сохранения (от последней контрольной точки, созданной, например, с помощью DATABASE START INCREMENT);

  6. Конструкция DATABASE STOP INCREMENT прекращает ведение нарастающего архивирования: последняя контрольная точка удаляется, а архивный файл закрывается. Т.к. по этому SQL-запросу сохранение в архивном файле последней порции накопленных в БД изменений (т. е. начиная с последней контрольной точки) не осуществляется, то перед его выполнением необходимо подать SQL-запрос BACKUP DATABASE INCREMENT для исключения потери архивных данных;

  7. Опция DEVICE задает логическое имя устройства, на котором должен создаваться файл архива. Устройство должно быть описано в системной таблице $$$DEVICE. Если имя устройства не задано, по умолчанию используется переменная окружения SY00. Если SY00 не определена, архив создается в каталоге запуска ядра СУБД ЛИНТЕР.

    Пример:

    BACKUP DATABASE DEVICE 'SY02' FILE 'h:\linter\arhiv\sale2804.lhb';
  8. < комментарий > задает текст комментария к архивному файлу;

  9. < пароль > задает пароль архивного файла;

  10. Конструкция VOLUMES < размер тома > [K|M] разрешает разбивать архивный файл на отдельные тома указанного < размера тома >: К – в Кбайтах, M – Мбайтах;

  11. Опция ASYNC задает асинхронное выполнение процесса архивирования.

Общие правила

Примечания

  1. По возможности использовать для архивирования БД утилиту lhb, а не SQL-запрос BACKUP DATABASE.

  2. Не использовать для архивирования БД SQL-запрос BACKUP DATABASE, если в БД есть фразовые индексы.

Если задана опция ASYNC, пользователю сразу будет возвращен код завершения, указывающий на результат выполнения SQL-запроса (успешный или неуспешный запуск процесса архивирования). В дальнейшем информацию о текущем состоянии процесса архивирования можно будет получать из системной таблицы $$$INKERNBACK (пункт «Мониторинг процессов асинхронного архивирования»).