Задача / по шагам
Перенести доработку одной транзакцией PostgreSQL
Включите одну транзакцию, проверьте откат (rollback) после ошибки итогового скрипта и задайте обязательную полную установку ZIP-пакета.
На этой странице
- 01План
Изменение и итоговая проверка
- 02Одна транзакция
Всё вместе или откат
- 03Повтор
Проверить результат
Учебный прогон 26 октября 2026: обновляем правило суммы с 0 до 100, затем выполняем итоговую проверку. Сначала проверка падает — функция остаётся прежней. После подготовки приёмки повтор проходит, новое сравнение пустое.
Учебный пример
Код установлен, а последняя проверка не прошла. В обычном режиме выполненные изменения уже могут остаться в базе. В PostgreSQL можно заранее выбрать одну транзакцию для всего плана: ошибка итоговой проверки тогда отменит и предшествующие изменения.
Покажем обе ветки одного переноса — отказ и успешный повтор.
Обрыв связи во время применения
Если соединение с приёмником не удалось открыть заново, Holkas останавливает перенос при первой неудаче, без повторных попыток. В обычном режиме исходы выполненных команд сохраняются, оставшиеся получают «Не выполнялась: нет связи с приёмником». При одной транзакции причина обрыва не подменяется ошибкой отката.
Если связь оборвалась в сам момент фиксации, результат неизвестен: команда может считаться неудавшейся, хотя запись сохранилась. В режиме одной транзакции в этом случае исходы теряются. Восстановите связь и постройте новый план; не повторяйте применение вслепую. Разбор частичного переноса.
Правило суммы
parus.hksite_v25_amount_ok(amount numeric): новая версия принимает сумму не меньше 100.
Итоговая проверка
Скрипт «Проверить готовность приёмки» выполняется после всех изменений и поднимает ошибку, если учебная приёмка не готова.
Режим установки
Параметр «Перенести одной транзакцией» включён для этого плана.
Перед началом
- 01
Приёмник — PostgreSQL
У приёмника должна быть PostgreSQL. Для Oracle общего режима нет — DDL фиксируется самой СУБД. Согласуйте время установки и подготовьте резервную копию базы.
- 02
Проверка, которая завершает SQL ошибкой
Скрипт «после» может проверить итог установки. Чтобы остановить перенос, он должен вызвать ошибку, например RAISE EXCEPTION. Запрос, который просто вернул false, не означает отказа. Формат и порядок — в главе о скриптах.
- 03
Учебные данные
Здесь готовность задаёт одна искусственная строка parus.hksite_v25_ready. Это условие только нашего примера; для своей доработки запишите проверку, которая имеет прикладной смысл.
Включите режим на шаге «Параметры»
Выберите источник, приёмник PostgreSQL и состав доработки. Перейдите на четвёртый шаг. У параметра «Перенести одной транзакцией» выберите «Да» и запустите план.
Постоянное значение можно задать на странице подключения, панель «Параметры приёмника». Для этого нужно право управления подключением.
Проверьте изменение и итоговый скрипт
В плане нашего примера две команды — Update функции и Create скрипта автора. Скрипт стоит последним и выполнится при переносе. В шапке есть метка «одной транзакцией»; откройте команды и проверьте SQL перед применением.
Пока вы читаете план, база не заблокирована. Блокировки изменяемых объектов удерживаются во время применения, до фиксации или отката. Ожидание блокировки ограничено 30 секундами.
Разберите отказ и убедитесь в откате
В учебной приёмке готовность выключена. После применения скрипт сообщает «Итоговая проверка — приёмка ещё не готова», операция завершается ошибкой. Изменение функции откатилось вместе со всей транзакцией.
До и после отказа функция принимала 0. Повторный план содержит те же две команды. Сначала прочитайте причину, затем проверьте состояние приёмника — один неуспешный статус не объясняет результат.
Подготовьте приёмку и примените свежий план
В примере меняем только искусственный признак готовности и применяем заново построенный план с тем же параметром. Теперь итоговая проверка проходит; обе команды завершаются успешно, транзакция фиксируется.
Финализация — регистрация объектов в Парусе — идёт отдельным шагом после фиксации. Её сбой не откатывает уже установленный план: проверьте журнал. Повторный перенос без изменений регистрацию не повторит: её восстанавливают средствами Паруса.
Сравните тот же состав ещё раз
Постройте новый план между теми же базами с теми же параметрами. В учебном прогоне он пустой — функция совпадает. Скрипт сам по себе не создаёт изменение, если у его объектов не осталось команд.
Записи журналов Паруса и внешние эффекты SQL откатом транзакции не отменяются. Учитывайте это при написании собственных скриптов.
Режим виден
У плана сохранён параметр и его источник.
Отказ разобран
Причина ошибки и состояние после отката проверены.
Результат подтверждён
Успешное применение завершено, повторный план пустой.
Запишите требование в ZIP при выгрузке
Выберите «Файл пакета» или S3 приёмником и откройте шаг «Параметры». Включите «Перенести одной транзакцией», затем выгрузите пакет. В его manifest.json запишется singleTransaction=true.
Требование хранится в самом ZIP. Сохранение только списка объектов в манифест состава его не переносит.
Проверьте обязательный режим при установке ZIP
Загрузите полученный ZIP источником и выберите базу PostgreSQL приёмником. Постройте план. В его шапке появится метка «одной транзакцией · требует пакет». Требование действует независимо от настроек приёмника; явное выключение в параметрах плана вызовет отказ. Разберите команды до применения.
Нужен весь пакет. Исключённые команды, команды «вне плана», явное выключение режима или приёмник Oracle вызывают отказ до первой записи. Для иного состава соберите другой пакет.
Если что-то пошло не так
Нужна только часть обязательного пакета
Снятие команд нарушает требование полной установки. Включите их обратно или пересоберите сам пакет с нужным составом.
Другая сессия держит блокировку
Holkas ждёт не дольше 30 секунд. При отказе общая транзакция откатывается; согласуйте время работ и разберите журнал перед повтором.
Приёмник — SQL-файл
Для PostgreSQL параметр добавляет BEGIN … COMMIT в файл. Выполняйте его с psql -v ON_ERROR_STOP=1. Создание файла ещё не означает применение к базе. Как проверить SQL-выгрузку.
Промежуточное хранение в Git
Git не сохраняет требование ZIP. План предупреждает о потере; при следующем переносе из Git задайте режим заново, если он нужен.