Задача / по шагам
Проверить данные перед переносом доработки
Добавьте скрипт автора к объектам решения. Holkas покажет результат проверки на плане и остановит зависимые команды, если данные ещё не готовы.
На этой странице
- 01Правило автора
Проверка данных приёмника
- 02План
Результат и блокировка
- 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/<имя> и выполняется, когда перенос приходит в базу.
Проверка
«Проверить суммы договоров» — SQL с понятным сообщением об ошибке.
Изменяемая функция
parus.hksite_v23_amount_ok — правило допустимой суммы договора.
Данные приёмника
Одна искусственная строка в отдельной учебной таблице. Скрипт её читает, но не исправляет.
Перед началом
- 01
Сформулируйте условие готовности
Какие данные сделают новую доработку неверной даже при успешном создании структуры? Запишите это условие запросом и понятной ошибкой.
- 02
Назовите защищаемые объекты
В описание скрипта входят типы и имена объектов. Пустой список означает весь перенос. Holkas не выводит эти связи из текста SQL.
- 03
Подготовьте текст для приёмника
Для PostgreSQL и Oracle тексты задаются отдельно. Если для СУБД приёмника текста нет, перенос откажет до построения плана.
Добавьте скрипт к составу
На шаге «Объекты» выберите «Скрипт автора» → «Новый скрипт». Укажите имя, «До объектов», функцию из примера и включите выполнение при построении плана. Введите PostgreSQL-текст проверки. Скрипт можно также редактировать на своей странице в манифесте.
Само сохранение скрипта ничего не выполняет. Команда появится в плане, только если выбранным объектам есть что менять.
Посмотрите отказ проверки на плане
Запустите план. Проверка найдёт отрицательную сумму и вызовет RAISE EXCEPTION. На строке скрипта виден текст ошибки; изменение функции помечено как заблокированное этим скриптом.
Скрипт запускается в базе-приёмнике. Успех построения самого плана не означает, что проверка данных прошла.
Подготовьте данные и постройте новый план
Разберите причину вместе с ответственным за данные. В учебном примере мы исправили только искусственную строку DEMO-001 с −10 на 10. После повторного построения проверка прошла.
Не заменяйте разбор причины отключением скрипта. Снятие скрипта «до» исключит и команды, которые его ждут.
Примените и проверьте сходимость
Примените готовый план и выполните ещё одно сравнение того же состава. Когда функция уже соответствует источнику, её проверка не создаёт отдельной команды — повторный план пустой.
Проверку выполняют и на плане, и при применении, потому что данные между этими моментами могли измениться.
Правило записано
Проверка хранится вместе с составом доработки.
Причина видна
Ошибка называет проблему с данными, а не только отказ SQL.
Повтор сошёлся
Нет изменений объектов — нет лишнего запуска скрипта.
Если что-то пошло не так
Скрипт после объектов упал
В обычном режиме выполненные команды остаются, поэтому проверку готовности ставьте «до». В режиме одной транзакции PostgreSQL ошибка скрипта «после» откатывает весь план: так можно задать итоговую проверку установки.
Откат на плане имеет границы
Holkas всегда откатывает транзакцию пробного запуска. Но DDL Oracle, явно фиксирующие изменения процедуры Паруса и внешние эффекты SQL этим не отменяются. Для такой работы выполнение при построении плана включать нельзя.
Текст для одной СУБД не переводится в другую
Напишите оба варианта самостоятельно. Если на одной СУБД действий не требуется, задайте явный пустой блок; отсутствие текста считается ошибкой.
Падает обычная команда, а не скрипт
Правило то же — все команды, которые ждут упавшую по связям плана, пропускаются с указанием причины. В обычном режиме независимые команды продолжают работу без общего отката. В режиме одной транзакции PostgreSQL ошибка откатывает весь план.