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

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

Проверить данные перед переносом доработки

Добавьте скрипт автора к объектам решения. Holkas покажет результат проверки на плане и остановит зависимые команды, если данные ещё не готовы.

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

    Проверка данных приёмника

  2. 02
    План

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

  3. 03
    Перенос

    Повтор проверки перед объектами

Учебный пример: в приёмнике есть договор с отрицательной суммой. Скрипт останавливает изменение функции; после исправления учебной строки проверка проходит, перенос завершается, повторный план пустой.

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

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

В нашем примере функция меняется с amount > 0 на amount >= 0. До установки проверяем, что в учебных данных вообще нет отрицательных сумм:

DO $$
BEGIN
  IF EXISTS (
    SELECT 1 FROM parus.hksite_v23_check_data WHERE amount < 0
  ) THEN
    RAISE EXCEPTION
      'Есть договор с отрицательной суммой. Исправьте данные перед переносом.';
  END IF;
END
$$;

Это обычный SQL автора с ошибкой при нарушении правила. Отдельного языка проверок нет. Описание хранится в строке манифеста SCR; в Git и ZIP-пакете скрипт едет файлом CustomScript/<имя> и выполняется, когда перенос приходит в базу.

SCR

Проверка

«Проверить суммы договоров» — SQL с понятным сообщением об ошибке.

JFP

Изменяемая функция

parus.hksite_v23_amount_ok — правило допустимой суммы договора.

DEMO-001

Данные приёмника

Одна искусственная строка в отдельной учебной таблице. Скрипт её читает, но не исправляет.

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

  • 01

    Сформулируйте условие готовности

    Какие данные сделают новую доработку неверной даже при успешном создании структуры? Запишите это условие запросом и понятной ошибкой.

  • 02

    Назовите защищаемые объекты

    В описание скрипта входят типы и имена объектов. Пустой список означает весь перенос. Holkas не выводит эти связи из текста SQL.

  • 03

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

    Для PostgreSQL и Oracle тексты задаются отдельно. Если для СУБД приёмника текста нет, перенос откажет до построения плана.

Добавьте скрипт к составу

На шаге «Объекты» выберите «Скрипт автора» → «Новый скрипт». Укажите имя, «До объектов», функцию из примера и включите выполнение при построении плана. Введите PostgreSQL-текст проверки. Скрипт можно также редактировать на своей странице в манифесте.

Страница скрипта автора с объектом, моментом выполнения и SQL проверки
Текст и привязка к объектам — часть описания скрипта. Он не читается из таблицы базы-источника.

Само сохранение скрипта ничего не выполняет. Команда появится в плане, только если выбранным объектам есть что менять.

Посмотрите отказ проверки на плане

Запустите план. Проверка найдёт отрицательную сумму и вызовет RAISE EXCEPTION. На строке скрипта виден текст ошибки; изменение функции помечено как заблокированное этим скриптом.

Скрипт обнаружил отрицательную сумму; изменение функции заблокировано
Авторское сообщение объясняет причину до изменения функции. План не скрывает, какой скрипт остановил объект.

Скрипт запускается в базе-приёмнике. Успех построения самого плана не означает, что проверка данных прошла.

Подготовьте данные и постройте новый план

Разберите причину вместе с ответственным за данные. В учебном примере мы исправили только искусственную строку DEMO-001 с −10 на 10. После повторного построения проверка прошла.

Скрипт проверки прошёл, изменение функции доступно к выполнению
План построен заново после исправления данных. При применении скрипт выполнится ещё раз.

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

Примените и проверьте сходимость

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

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

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

Правило записано

Проверка хранится вместе с составом доработки.

Причина видна

Ошибка называет проблему с данными, а не только отказ SQL.

Повтор сошёлся

Нет изменений объектов — нет лишнего запуска скрипта.

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

Скрипт после объектов упал

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

Откат на плане имеет границы

Holkas всегда откатывает транзакцию пробного запуска. Но DDL Oracle, явно фиксирующие изменения процедуры Паруса и внешние эффекты SQL этим не отменяются. Для такой работы выполнение при построении плана включать нельзя.

Текст для одной СУБД не переводится в другую

Напишите оба варианта самостоятельно. Если на одной СУБД действий не требуется, задайте явный пустой блок; отсутствие текста считается ошибкой.

Падает обычная команда, а не скрипт

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