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

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

Получить SQL-скрипт функции и проверить его

Выберите функцию базы, скачайте её SQL и выполните файл самостоятельно. Разберём владельца, права и проверку результата новым сравнением.

На этой странице
  1. 01
    База-источник

    Функция проверки суммы

  2. 02
    SQL-файл

    Определение, владелец и права

  3. 03
    Ваша база

    Самостоятельное выполнение и сверка

Пример записан 26 октября 2026. Скачанный файл исполнен без ручной правки, вызовы 99/100 проверены; повторное сравнение функции пустое.

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

Иногда нужен именно текст SQL: прочитать определение функции, передать его администратору или выполнить своим клиентом. Приёмник «SQL-скрипт» создаёт такой файл. Доступ к будущей базе-приёмнику при выгрузке не нужен.

Из учебной доработки согласования договоров возьмём только функцию parus.f_hksite_contract_check: в версии правила 1.2 она принимает суммы от 100. Класс договоров, таблица и статусы в эту выгрузку не входят.

Несколько объектов в одном файле

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

Приёмник «SQL-скрипт» работает только с поддерживаемыми объектами базы своего диалекта. Экспорт в SQL и пользовательский скрипт Паруса SCR — разные возможности: SCR выполняет свой код в ходе переноса, а приёмник «SQL-скрипт» отдаёт файл для самостоятельного выполнения.

JFP

Одна функция

parus.f_hksite_contract_check(amount numeric): сумма договора не меньше 100.

.sql

Текст команд

Полное определение функции и команды владельца и прав. План для конкретной базы в файл не входит.

99 → false · 100 → true

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

Функция отвечает правильно; определение, владелец и права совпадают с источником.

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

  • 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-скрипт» и одна выбранная функция JFP
После выбора объектов есть шаг «Параметры» и у файлового приёмника.

У файла нет состояния базы для сравнения, поэтому план отличий здесь не строится. В файл попадёт текущее определение выбранной функции. Выгрузка сама не выполняет этот SQL в базе.

Выберите, оборачивать ли SQL в транзакцию

У приёмника «SQL-скрипт» есть шаг «Параметры». Для PostgreSQL здесь доступно «Перенести одной транзакцией» — в файл добавятся BEGIN и COMMIT. В этом примере оставляем «По умолчанию — нет» и нажимаем «Выгрузить скрипт»; транзакцию при выполнении зададим самому psql.

Параметры SQL-выгрузки PostgreSQL — одна транзакция оставлена по умолчанию выключенной
Параметры владельцев и сравнения прав здесь скрыты. Файл создаётся без сравнения с конкретной базой.

Для файла с BEGIN … COMMIT используйте psql -v ON_ERROR_STOP=1 без дополнительного --single-transaction. Для Oracle этот параметр неприменим. Поведение режима.

Скачайте результат операции

Дождитесь завершения и нажмите «Скачать contract-check-1.2.sql». Ниже можно скачать тот же файл из учебного прогона или раскрыть его содержимое прямо на странице.

Завершённая выгрузка функции с кнопкой скачивания 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)
Повторное сравнение функции разработки с приёмкой после выполнения SQL — расхождений не выявлено
Holkas проверяет уже изменённую базу новым сравнением. Самостоятельное выполнение файла не является операцией применения Holkas.

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

Файл получен

Сохранены SQL и сведения о том, из какой базы он выгружен.

SQL выполнен

Клиент завершился успешно; проверен вызов функции.

Состояние сверено

Новый план пустой; проверены владелец и права.

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

Файл выгружен старой версией

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

В наборе класс, метод или DAT

Приёмник «SQL-скрипт» принимает поддерживаемые объекты самой базы. Для логических объектов Паруса и наборов данных используйте перенос в базу, Git или ZIP-пакет.

Роль владельца или получателя прав отсутствует

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

Функция с такими аргументами уже существует

CREATE OR REPLACE подходит для совместимых изменений определения. При несовместимой замене PostgreSQL может отказать. У SQL-файла нет запасного пути и плана с пересозданием, как у прямого применения JFP; сначала проверьте файл на копии своей базы.

Нужен план до изменения базы

Выберите базу приёмником в Holkas или передайте ZIP-пакет и сравните его с базой получателя. Внешнее выполнение SQL не проходит через выбор команд и подтверждение плана Holkas.