infobase restore
Восстановите базу из DT, заменив текущие данные.
Примеры ответов; пути и длительность зависят от запуска.
infobase restore --replace / --create 
v8-runner infobase restore --input build/main.dt --replace
загружает базу из .dt, уничтожая текущие данные
На платформе ниже 8.3.27 команду выполняет Конфигуратор: агент там просит подтвердить свой перезапуск (версии платформы).
Классы ответов
Классы относятся ко всем вариантам этой команды; условия отдельных ключей указаны в строках. Примеры ниже показывают форму ответа, а не все сочетания настроек.
| Класс | Когда возникает и что означает |
|---|---|
| База восстановлена | restored — true; target_mode отдельно сообщает create / replace. |
| План подготовлен | restored — false, target_state — unchanged; база ещё не менялась. |
| Восстановление не разрешено | DT не читается/пуст/не того типа, --create на существующей базе либо --replace на отсутствующей; утилита/каталог недоступны. |
| Восстановление не завершилось | restored — false. После запуска платформы состояние базы может быть uncertain; это не гарантия, что она осталась прежней. |
| Результат восстановления не подтверждён | execution.status — invalid_output; факт успешного восстановления не установлен. |
| Выполнение прервано | cancelled / timed_out; при критическом изменении базы прерывание может быть отложено, а завершение сопровождаться предупреждением. |
| Восстановление завершено с предупреждением | Операция уже выполнена; отложенное прерывание/сопутствующая диагностика не превращают её в невыполненную. |
Причины отказов и различия между ошибкой команды, ошибкой шага и диагностикой запуска — в словаре ответов.
Варианты ответа
Операция завершилась успешно
Фрагмент успешного текстового ответа:
mode: apply
input: build/main.dt
restored: true
Восстановление началось, но не завершилось
uncertain не означает, что база сохранена в прежнем виде. execution хранит диагностику, restored остаётся false.
restored: false
target state: uncertain
execution status: failed
warning: publication rollback failed; the output target requires manual inspection
ERROR: platform error: DT restoration failed
infobase restore --input build/main.dt --replace --dry-run 
v8-runner infobase restore --input build/main.dt --replace --dry-run
Превью проверяет настройки и доступность исполнителя. Платформа не запускается; база и выходные файлы не меняются. Без --dry-run выполняется указанная операция. Для восстановления обязателен ровно один ключ: --create или --replace; второй заменяет данные существующей базы.
Варианты ответа
План замещения подготовлен
Успех превью подтверждает подготовку плана, а не выполнение операции. Фрагмент текстового ответа:
command: infobase.restore
mode: preview
provider dispatched: false