Задача / по шагам
Получить SQL-скрипт функции и проверить его
Выберите функцию базы, скачайте её SQL и выполните файл самостоятельно. Разберём владельца, права и проверку результата новым сравнением.
На этой странице
- 01База-источник
Функция проверки суммы
- 02SQL-файл
Определение, владелец и права
- 03Ваша база
Самостоятельное выполнение и сверка
Пример записан 26 октября 2026. Скачанный файл исполнен без ручной правки, вызовы 99/100 проверены; повторное сравнение функции пустое.
Учебный пример
Иногда нужен именно текст SQL: прочитать определение функции, передать его администратору или выполнить своим клиентом. Приёмник «SQL-скрипт» создаёт такой файл. Доступ к будущей базе-приёмнику при выгрузке не нужен.
Из учебной доработки согласования договоров возьмём только функцию parus.f_hksite_contract_check: в версии правила 1.2 она принимает суммы от 100. Класс договоров, таблица и статусы в эту выгрузку не входят.
Несколько объектов в одном файле
В пример входит одна функция, но в файл можно выгрузить и связанную группу объектов базы: таблицы с ограничениями, индексами и триггерами, последовательности, представления, функции и процедуры, а также составные типы PostgreSQL, пакеты и синонимы Oracle. Команды идут в том же порядке, что при переносе в пустую базу: триггер — после своей функции, внешний ключ — после таблицы, на которую ссылается, права — после своего объекта. Файл Oracle, как и перенос в базу, заканчивается пересборкой затронутых схем.
Приёмник «SQL-скрипт» работает только с поддерживаемыми объектами базы своего диалекта. Экспорт в SQL и пользовательский скрипт Паруса SCR — разные возможности: SCR выполняет свой код в ходе переноса, а приёмник «SQL-скрипт» отдаёт файл для самостоятельного выполнения.
Одна функция
parus.f_hksite_contract_check(amount numeric): сумма договора не меньше 100.
Текст команд
Полное определение функции и команды владельца и прав. План для конкретной базы в файл не входит.
Результат проверки
Функция отвечает правильно; определение, владелец и права совпадают с источником.
Перед началом
- 01
Актуальная версия Holkas
Подойдёт последний выпуск. Несколько связанных объектов он записывает в порядке команд переноса.
- 02
Объекты базы и тот же диалект
Выбирайте объекты SQL, а не классы и другие объекты КОР. Для функции JFP нужна база PostgreSQL. PL/SQL в PL/pgSQL не переводится.
- 03
Доступ для выполнения
Для выгрузки нужен доступ на чтение источника. Для выполнения файла отдельно нужны подключение к своей базе, необходимые роли и права. Первый запуск выполняйте на учебной базе или копии.
Выберите функцию и приёмник «SQL-скрипт»
В разделе «Перенести» выберите базу источником, а «SQL-скрипт» — приёмником. Укажите имя contract-check-1.2.sql. На шаге «Объекты» найдите JFP parus.f_hksite_contract_check, добавьте её в перенос и перейдите на шаг «Параметры».
У файла нет состояния базы для сравнения, поэтому план отличий здесь не строится. В файл попадёт текущее определение выбранной функции. Выгрузка сама не выполняет этот SQL в базе.
Выберите, оборачивать ли SQL в транзакцию
У приёмника «SQL-скрипт» есть шаг «Параметры». Для PostgreSQL здесь доступно «Перенести одной транзакцией» — в файл добавятся BEGIN и COMMIT. В этом примере оставляем «По умолчанию — нет» и нажимаем «Выгрузить скрипт»; транзакцию при выполнении зададим самому psql.
Для файла с BEGIN … COMMIT используйте psql -v ON_ERROR_STOP=1 без дополнительного --single-transaction. Для Oracle этот параметр неприменим. Поведение режима.
Скачайте результат операции
Дождитесь завершения и нажмите «Скачать contract-check-1.2.sql». Ниже можно скачать тот же файл из учебного прогона или раскрыть его содержимое прямо на странице.
«Завершено» здесь означает, что Holkas создал файл. Это ещё не подтверждение его выполнения на вашей базе. Последующие правки источника в сохранённый файл не попадут.
Прочитайте определение, владельца и права
В файле сначала идёт CREATE OR REPLACE FUNCTION с правилом amount >= 100. После тела стоит завершающий разделитель, затем блок DO для владельца и прав. Если у функции несколько вариантов с разными аргументами, блок обрабатывает каждый из них по его полной сигнатуре.
Тело закончено
После последнего определения есть отдельная строка с точкой с запятой. Следующая команда не склеивается с CREATE FUNCTION.
Аргументы учитываются
Владелец и права назначаются каждому варианту: например, check_amount(numeric) и check_amount(text) различаются списком аргументов.
Объект выгружен целиком
Это определение из источника, а не разница с вашей базой. Исчезнувшие перегрузки не удаляются как при командном применении Holkas.
Роль владельца и получатели прав должны существовать в вашей базе. SQL-файл не создаёт роли. Если источник не даёт EXECUTE для PUBLIC, выгрузка снимает автоматическое право PostgreSQL. У прав с передачей сохраняется WITH GRANT OPTION.
Выполните файл на своей учебной базе
Для PostgreSQL используйте psql. В команде замените сервер, базу и пользователя; пароль задайте обычным способом для клиента, например через .pgpass. Здесь --single-transaction выполняет всю выгрузку одной функции в одной транзакции, а ON_ERROR_STOP останавливает выполнение при первой ошибке.
psql -X -h localhost -U parus -d demo \
-v ON_ERROR_STOP=1 --single-transaction \
-f contract-check-1.2.sqlВывод psql при выполнении скачанного файла на учебной приёмке
CREATE FUNCTION
DOВ учебном прогоне выполнен скачанный файл без ручных изменений. У другого состава объектов могут быть другие требования к транзакции и повторному выполнению. В Oracle используют свой клиент, например SQL*Plus; команда psql для него не подходит.
Проверьте вызов и повторите сравнение
Вызовите функцию с суммой ниже порога и на самом пороге. Затем в Holkas сравните исходную базу с той, где выполнили SQL, выбрав ту же функцию. В нашем прогоне значения верны, а повторный план пустой. Отдельной SQL-сверкой также проверены определение, владелец и действующие права.
SELECT parus.f_hksite_contract_check(99) AS amount_99,
parus.f_hksite_contract_check(100) AS amount_100;Ответ PostgreSQL после выполнения файла
amount_99 | amount_100
-----------+------------
f | t
(1 row)
Пустой план подтверждает совпадение по правилам сравнения Holkas. Проверку работы функции и нужных прав выполняйте отдельно; Holkas не знает, каким внешним клиентом и когда был исполнен SQL-файл.
Файл получен
Сохранены SQL и сведения о том, из какой базы он выгружен.
SQL выполнен
Клиент завершился успешно; проверен вызов функции.
Состояние сверено
Новый план пустой; проверены владелец и права.
Если что-то пошло не так
Файл выгружен старой версией
В файле, выгруженном версией 0.1.35 или более ранней, триггер мог оказаться раньше своей функции, а внешний ключ — раньше таблицы, на которую ссылается. Сохранённые файлы сами не исправляются; выгрузите набор заново.
В наборе класс, метод или DAT
Приёмник «SQL-скрипт» принимает поддерживаемые объекты самой базы. Для логических объектов Паруса и наборов данных используйте перенос в базу, Git или ZIP-пакет.
Роль владельца или получателя прав отсутствует
Подготовьте нужную роль и права в приёмнике либо согласуйте перевод ролей при переносе. Выгрузка не создаёт учётные записи; изменение текста файла само по себе не проверяет корректность ваших правил доступа.
Функция с такими аргументами уже существует
CREATE OR REPLACE подходит для совместимых изменений определения. При несовместимой замене PostgreSQL может отказать. У SQL-файла нет запасного пути и плана с пересозданием, как у прямого применения JFP; сначала проверьте файл на копии своей базы.
Нужен план до изменения базы
Выберите базу приёмником в Holkas или передайте ZIP-пакет и сравните его с базой получателя. Внешнее выполнение SQL не проходит через выбор команд и подтверждение плана Holkas.