Holkas
Написать в поддержку Поддержка

Как это работает / 03 из 05

Как применяется план

Holkas упорядочивает команды, учитывает ваш выбор и записывает результат каждой попытки. Разберём зависимости, изменения базы после сравнения и частично выполненный перенос.

На этой странице

Просмотр плана не блокирует базу. По умолчанию ошибка не откатывает весь перенос; для PostgreSQL можно выбрать одну транзакцию. Перед повтором проверьте режим и исходы команд.

Порядок команд и недостающие объекты

Порядок уже определён при построении плана: из команд и их связей получена очередь. Граф и топологическая сортировка подробно разобраны в предыдущей главе. Команды выполняются последовательно; соседние строки не обязательно относятся к одному объекту.

Перед записью проверьте предупреждения о непокрытых зависимостях. Объект может уже существовать в приёмнике — тогда отдельное создание не нужно. Но если его нет ни в плане, ни в приёмнике, одна сортировка проблему не решит: нужно дополнить состав или подготовить объект отдельно. В интерфейсе для этого есть «Недостающие» → «Добавить в набор и перестроить». Кнопка создаёт новый план с расширенным набором, без применения. Как это выглядит на примере домена.

Если применить только часть плана

Выбранные команды запускаются вместе с обязательными предшественниками из того же плана. При исключении предшественника исключаются зависимые от него команды. На интерактивном графе можно увидеть оба направления: выбрать итоговую команду D или исключить домен E.

Это согласование выбранных команд, а не добавление объектов в исходный состав. Предположительные связи из SQL-текста в каскадном выборе не участвуют. Как они отличаются от подтверждённых, объясняется в разборе зависимостей.

Если источник — пакет с требованием установки одной транзакцией, исключать команды нельзя: Holkas откажет до первой записи. Измените состав самого пакета или установите его целиком. Пример такого пакета.

Если база изменилась после построения плана

Перед применением Holkas заново определяет необходимые команды. Сохранённый план не блокирует приёмник на время вашего просмотра.

Как запускаетеЕсли появились команды сверх сохранённого плана
Весь план без исключенийНовые необходимые команды могут выполниться. В журнале они отмечаются как «вне плана».
Часть плана или план с исключениямиПрименение останавливается до первой записи. Нужно построить и проверить новый план.

Для пакета с требованием одной транзакции появление команд «вне плана» тоже означает отказ до записи, даже когда выбран весь план. Постройте и проверьте новый план.

Эта проверка касается появления новых команд; она не превращает просмотренный diff в заблокированный снимок базы. Если известно об изменениях после сравнения, постройте свежий план и согласуйте время применения с коллегами.

Обычный режим: ошибка не откатывает весь перенос

След выполнения

Операция неуспешна. База уже изменилась.

№КомандаОбъектИсход
01Создать классКласс RequestВыполнено
02Добавить атрибутКласс RequestОшибка
03Выставить порядокКласс RequestПропущено
04Обновить функциюФункцияВыполнено
Класс создан. Функция обновлена. Атрибут не добавлен.

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

  1. 01
    Найти причину

    Прочитать отказ и исходы команд.

  2. 02
    Исправить условие

    Устранить причину в согласованном порядке.

  3. 03
    Сравнить заново

    Увидеть, какие отличия ещё остались.

Условный пример обычного отказа команды без режима одной транзакции. Последовательность поясняет правила выполнения и не является журналом реальной операции.

По умолчанию операция выполняет команды последовательно, без общей транзакции. При обычном отказе команды Holkas записывает ошибку и пропускает оставшиеся команды того же объекта, а также все команды, которые ждут упавшую по связям плана, — так же, как если бы с неё сняли галочку. У пропущенной команды указано, какая команда её остановила. Остальное продолжает выполняться. Итог операции будет неуспешным, но успешно выполненные изменения уже могут остаться в базе.

Потеря соединения или другой инфраструктурный сбой может оборвать запуск. В обычном режиме общего отката нет. Нельзя считать, что после ошибки приёмник остался в исходном состоянии.

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

Если Парус отказал, потому что значение уже занято другой записью (нарушено уникальное ограничение), Holkas пишет это словами: какое ограничение, что запись не изменилась, и как быть, если две записи меняются значениями (временное значение и перенос по одной записи). Исходный ответ СУБД приводится в конце сообщения.

Сначала разберите журнал и исходы команд, затем устраните причину и выполните новое сравнение — пошаговый пример частичного переноса. Оно покажет оставшиеся отличия. При необходимости восстановите базу из резервной копии. Учтите, что скрипт автора выполнится снова, если у его объектов в новом плане остались команды. Если изменений нет, скрипт не создаёт отдельного запуска.

PostgreSQL: весь план одной транзакцией

На шаге «Параметры» можно включить «Перенести одной транзакцией». Тогда транзакция открывается перед первой командой и фиксируется после последней. Ошибка любой команды, включая скрипт автора «после», откатывает изменения всех команд. В исходах видно «откачена» или «не выполнялась». На странице операции показан выбранный режим.

Изменённые объекты остаются заблокированными для других сеансов до конца транзакции. Ожидание блокировки ограничено 30 секундами. Записи журналов Паруса и внешние эффекты скриптов откат не отменяет. Финализация — регистрация объектов в Парусе — выполняется после фиксации отдельно; её ошибку разбирают по журналу, а не считают откатом уже установленного пакета.

Для Oracle общего режима нет: DDL фиксируется самой СУБД. У файлового приёмника параметр имеет другое назначение: в ZIP записывает обязательное требование к будущей установке, а в PostgreSQL SQL-файл добавляет BEGIN … COMMIT. В Git требование пакета не сохраняется, и план предупреждает об этом.

Проверенный пример: отказ итоговой проверки, откат и успешный повтор.

Права и подтверждение

Сравнение требует чтения источника и приёмника. Применение к базе дополнительно требует права записи в приёмник. Эти права можно назначить коллеге через группу и проверить в его карточке.

Веб-интерфейс, CLI и ИИ-агент обращаются к общему механизму переноса. При работе через MCP применение к базе требует подтверждения человека; агент действует с правами пользователя, от имени которого подключён. Подтверждение не заменяет проверку состава и приёмника. Настройка описана в подключении агента, его участие видно в истории и аудите.

До запуска и после него

Перед изменением важной базы проверьте направление, состав, diff и предупреждения. Подготовьте резервную копию самой базы-приёмника и способ её восстановления. Копия установки Holkas сохраняет настройки и историю сервера, но не заменяет копию базы Паруса.

После запуска просмотрите исходы команд, включая пропуски и команды «вне плана», и проверьте доработку в Парусе. Повторное сравнение помогает найти оставшиеся расхождения, а проверка приложения — убедиться, что результат решает вашу задачу.

В первом переносе этот путь показан на реальных экранах. Если проблема возникла ещё при подключении или построении плана, начните с разбора ошибок до применения.

Обрыв связи во время применения

Если соединение с приёмником не удалось открыть заново, Holkas останавливает перенос при первой неудаче, без повторных попыток. В обычном режиме исходы выполненных команд сохраняются, оставшиеся получают «Не выполнялась: нет связи с приёмником». При одной транзакции причина обрыва не подменяется ошибкой отката.

Если связь оборвалась в сам момент фиксации, результат неизвестен: команда может считаться неудавшейся, хотя запись сохранилась. В режиме одной транзакции в этом случае исходы теряются. Восстановите связь и постройте новый план; не повторяйте применение вслепую. Разбор частичного переноса.