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

Задача / по шагам

Перенести доработку одной транзакцией PostgreSQL

Включите одну транзакцию, проверьте откат (rollback) после ошибки итогового скрипта и задайте обязательную полную установку ZIP-пакета.

На этой странице
  1. 01
    План

    Изменение и итоговая проверка

  2. 02
    Одна транзакция

    Всё вместе или откат

  3. 03
    Повтор

    Проверить результат

Учебный прогон 26 октября 2026: обновляем правило суммы с 0 до 100, затем выполняем итоговую проверку. Сначала проверка падает — функция остаётся прежней. После подготовки приёмки повтор проходит, новое сравнение пустое.

Учебный пример

Код установлен, а последняя проверка не прошла. В обычном режиме выполненные изменения уже могут остаться в базе. В PostgreSQL можно заранее выбрать одну транзакцию для всего плана: ошибка итоговой проверки тогда отменит и предшествующие изменения.

Покажем обе ветки одного переноса — отказ и успешный повтор.

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

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

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

JFP

Правило суммы

parus.hksite_v25_amount_ok(amount numeric): новая версия принимает сумму не меньше 100.

SCR

Итоговая проверка

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

singleTransaction

Режим установки

Параметр «Перенести одной транзакцией» включён для этого плана.

Перед началом

  • 01

    Приёмник — PostgreSQL

    У приёмника должна быть PostgreSQL. Для Oracle общего режима нет — DDL фиксируется самой СУБД. Согласуйте время установки и подготовьте резервную копию базы.

  • 02

    Проверка, которая завершает SQL ошибкой

    Скрипт «после» может проверить итог установки. Чтобы остановить перенос, он должен вызвать ошибку, например RAISE EXCEPTION. Запрос, который просто вернул false, не означает отказа. Формат и порядок — в главе о скриптах.

  • 03

    Учебные данные

    Здесь готовность задаёт одна искусственная строка parus.hksite_v25_ready. Это условие только нашего примера; для своей доработки запишите проверку, которая имеет прикладной смысл.

Включите режим на шаге «Параметры»

Выберите источник, приёмник PostgreSQL и состав доработки. Перейдите на четвёртый шаг. У параметра «Перенести одной транзакцией» выберите «Да» и запустите план.

Четвёртый шаг переноса с включённым параметром одной транзакции
Режим задан этому плану. «По умолчанию» взяло бы значение подключения-приёмника, затем настройки запуска сервера.

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

Проверьте изменение и итоговый скрипт

В плане нашего примера две команды — Update функции и Create скрипта автора. Скрипт стоит последним и выполнится при переносе. В шапке есть метка «одной транзакцией»; откройте команды и проверьте SQL перед применением.

План обновления функции и запуска итогового скрипта с меткой одной транзакции
Транзакция охватит обе команды. Построение этого плана итоговый скрипт не запускает — у него atPlan=false.

Пока вы читаете план, база не заблокирована. Блокировки изменяемых объектов удерживаются во время применения, до фиксации или отката. Ожидание блокировки ограничено 30 секундами.

Разберите отказ и убедитесь в откате

В учебной приёмке готовность выключена. После применения скрипт сообщает «Итоговая проверка — приёмка ещё не готова», операция завершается ошибкой. Изменение функции откатилось вместе со всей транзакцией.

Ошибка итогового скрипта и пропущенный исход функции после отката общей транзакции
У функции исход «пропущено»; причина исхода начинается с «Откачена». Независимый SQL-запрос подтвердил прежние определение, владельца и права функции.

До и после отказа функция принимала 0. Повторный план содержит те же две команды. Сначала прочитайте причину, затем проверьте состояние приёмника — один неуспешный статус не объясняет результат.

Подготовьте приёмку и примените свежий план

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

Обновление функции и итоговый скрипт успешно исполнены одной транзакцией
Новый порог сохранён. Прямой вызов функции вернул false для 99 и true для 100.

Финализация — регистрация объектов в Парусе — идёт отдельным шагом после фиксации. Её сбой не откатывает уже установленный план: проверьте журнал. Повторный перенос без изменений регистрацию не повторит: её восстанавливают средствами Паруса.

Сравните тот же состав ещё раз

Постройте новый план между теми же базами с теми же параметрами. В учебном прогоне он пустой — функция совпадает. Скрипт сам по себе не создаёт изменение, если у его объектов не осталось команд.

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

Записи журналов Паруса и внешние эффекты SQL откатом транзакции не отменяются. Учитывайте это при написании собственных скриптов.

Режим виден

У плана сохранён параметр и его источник.

Отказ разобран

Причина ошибки и состояние после отката проверены.

Результат подтверждён

Успешное применение завершено, повторный план пустой.

Запишите требование в ZIP при выгрузке

Выберите «Файл пакета» или S3 приёмником и откройте шаг «Параметры». Включите «Перенести одной транзакцией», затем выгрузите пакет. В его manifest.json запишется singleTransaction=true.

Параметры выгрузки ZIP — включено требование установки одной транзакцией
Для файлового приёмника параметр задаёт условия будущей установки. Обычные параметры сравнения здесь скрыты.

Требование хранится в самом ZIP. Сохранение только списка объектов в манифест состава его не переносит.

Проверьте обязательный режим при установке ZIP

Загрузите полученный ZIP источником и выберите базу PostgreSQL приёмником. Постройте план. В его шапке появится метка «одной транзакцией · требует пакет». Требование действует независимо от настроек приёмника; явное выключение в параметрах плана вызовет отказ. Разберите команды до применения.

Установка ZIP-пакета — в шапке операции показано требование одной транзакции
Требование прочитано из настоящего ZIP. На экране уже завершённая установка в учебную PostgreSQL; метка обязательного режима сохранена.

Нужен весь пакет. Исключённые команды, команды «вне плана», явное выключение режима или приёмник Oracle вызывают отказ до первой записи. Для иного состава соберите другой пакет.

Если что-то пошло не так

Нужна только часть обязательного пакета

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

Другая сессия держит блокировку

Holkas ждёт не дольше 30 секунд. При отказе общая транзакция откатывается; согласуйте время работ и разберите журнал перед повтором.

Приёмник — SQL-файл

Для PostgreSQL параметр добавляет BEGIN … COMMIT в файл. Выполняйте его с psql -v ON_ERROR_STOP=1. Создание файла ещё не означает применение к базе. Как проверить SQL-выгрузку.

Промежуточное хранение в Git

Git не сохраняет требование ZIP. План предупреждает о потере; при следующем переносе из Git задайте режим заново, если он нужен.