Программный код базы · PostgreSQL и Oracle
Функция хранит исполняемую программу под именем в базе. Например, доработка КОР Парус 8 вызывает функцию для расчёта суммы: перенос меняет её определение, а новые суммы вычисляются при последующих вызовах.
JFP / JFN + Схема.ИмяФункция и её перегрузки
Тип объекта в Holkas: JFP — функция PostgreSQL, JFN — функция Oracle. Holkas переносит определение с аргументами и результатом, настройки и права. PL/SQL автоматически не переводится в PL/pgSQL: для другой СУБД нужна отдельная реализация.
В PostgreSQL несколько функций могут иметь одно имя, но разные входные аргументы. Такие варианты называют перегрузками. Например, учебная parus.udo_f_amount(numeric) принимает число, а parus.udo_f_amount(text) — строку. Имя с типами входных аргументов называют сигнатурой. Это разные способы вызвать функцию, а не история её версий.
JFP · parus.udo_f_amount. Выбор включает все определения этого имени. Выбрать только вариант (numeric) как отдельную JFP нельзя. Права и владелец также представлены одним общим набором на имя.В Oracle отдельно стоящая функция одна на имя. Перегрузки подпрограмм внутри пакета относятся к пакету Oracle JPG. Настройка метода класса MET, описание пользовательской процедуры PCE и запись реестра CLO — отдельные объекты: выбор функции не создаёт их. CLO может хранить копию исходного текста, но перенос этой записи сам DDL не выполняет.
Что входит в перенос
У функции нет папки каталога Паруса: ни имя узла, ни полный путь с родителями не переносятся и не создаются. Schema — пространство имён СУБД. Каталоги FunctionPostgres/FunctionOracle в Git и ZIP — раскладка файлов экспорта.
Справочник полей
17 полей · 4 группы5 свойств PostgreSQL, 7 Oracle, 3 поля права и 2 поля адреса зависимости. Имена с большой буквы соответствуют YAML; в JSON первая буква маленькая. Служебные Valid и Owner Oracle учтены отдельно.
Как читать обозначения
Подсказка значка открывается мышью, клавишей Tab или нажатием.
Ключ задаёт сопоставление, «Сравнивается» — обнаруживаемую разницу, «По элементам» — отдельные команды прав. Dependencies служит порядку и проверке ссылок; сам список не изменяет программу. Обнаруженное различие не гарантирует, что СУБД разрешит запись.
Функция PostgreSQL · JFP5 полей
SchemaJFP · JSON: schemaстрокаЧасть ключаСхема функции- Назначение
- Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle.
- При переносе:
- Вместе с Name задаёт адрес объекта. Смена схемы означает другое сопоставление, а не перемещение старой функции. Схему или пользователя Oracle команда не создаёт. У PostgreSQL Schema и Name должны согласовываться с заголовками Body; Holkas исполняет этот текст, а не строит заголовки из двух полей.
NameJFP · JSON: nameстрокаЧасть ключаИмя без схемы- Назначение
- Например udo_f_amount. Типы аргументов здесь не указываются.
- При переносе:
- При отсутствии такого адреса будет Create; старое имя не переименовывается и не удаляется. В PostgreSQL адрес охватывает все перегрузки имени, а не одну сигнатуру. В Oracle подпрограммы внутри пакета относятся к JPG, а не JFN.
BodyJFP · JSON: bodyстрокаСравниваетсяПолное определение всех перегрузок- Назначение
- CREATE OR REPLACE FUNCTION из pg_get_functiondef: аргументы, результат, язык, свойства и программный текст. Определения одного имени соединены в порядке сигнатур.
- При переносе:
- Изменение даёт одну Update JFP на весь объект. CRLF/LF равны; пробелы и иное написание кода могут дать различие. Update сначала исполняет текст на месте, при 42P13/42723 пробует пересоздание; затем удаляет прежние перегрузки, которых текст не затронул. Аргументы и SECURITY DEFINER — часть Body, отдельных полей для них нет.
GrantsJFP · JSON: grantsсписокПо элементамПрава на функцию- Назначение
- Привилегии получателей. Для PostgreSQL список общий для всех перегрузок, а не отдельный для каждой.
- При переносе:
- Сопоставляются по Grantee:Privilege, порядок записей несущественен. Create выдаёт, Delete отзывает, Update меняет GRANT OPTION. [] означает пустой список прав и может породить отзывы. Для новой функции PostgreSQL отсчёт идёт от EXECUTE у PUBLIC: если его нет в Grants, появляется Delete JFP.Grant. Параметр пропуска лишних прав меняет правила отзыва.
OwnerJFP · JSON: ownerстрокаСравниваетсяРоль-владелец всех перегрузок- Назначение
- Отдельна от Schema. При чтении Holkas выбирает минимальное имя владельца среди перегрузок; различающиеся владельцы не представляются отдельно.
- При переносе:
- Явное имя назначается каждой перегрузке; роль должна существовать, а перенос — иметь полномочия её назначить. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется.
Функция Oracle · JFN7 полей
SchemaJFN · JSON: schemaстрокаЧасть ключаСхема функции- Назначение
- Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle.
- При переносе:
- Вместе с Name задаёт адрес объекта. Смена схемы означает другое сопоставление, а не перемещение старой функции. Схему или пользователя Oracle команда не создаёт. У PostgreSQL Schema и Name должны согласовываться с заголовками Body; Holkas исполняет этот текст, а не строит заголовки из двух полей.
NameJFN · JSON: nameстрокаЧасть ключаИмя без схемы- Назначение
- Например udo_f_amount. Типы аргументов здесь не указываются.
- При переносе:
- При отсутствии такого адреса будет Create; старое имя не переименовывается и не удаляется. В PostgreSQL адрес охватывает все перегрузки имени, а не одну сигнатуру. В Oracle подпрограммы внутри пакета относятся к JPG, а не JFN.
BodyJFN · JSON: bodyстрокаСравниваетсяИсходный текст отдельно стоящей функции- Назначение
- FUNCTION с аргументами, RETURN, настройками и телом из ALL_SOURCE, в порядке LINE. Заголовок обычно без схемы; CREATE OR REPLACE в это поле не входит.
- При переносе:
- Применение переключает CURRENT_SCHEMA и добавляет CREATE OR REPLACE к Body. Разница даёт Update JFN; Вне литералов CRLF/LF равны, а хвостовые пробелы строк и пустые крайние строки различием не считаются; текст литералов переносится точно. Значения аргументов и результат вызова при переносе не вычисляются.
GrantsJFN · JSON: grantsсписокПо элементамПрава на функцию- Назначение
- Привилегии получателей. Для PostgreSQL список общий для всех перегрузок, а не отдельный для каждой.
- При переносе:
- Сопоставляются по Grantee:Privilege, порядок записей несущественен. Create выдаёт, Delete отзывает, Update меняет GRANT OPTION. [] означает пустой список прав и может породить отзывы. Для новой функции PostgreSQL отсчёт идёт от EXECUTE у PUBLIC: если его нет в Grants, появляется Delete JFP.Grant. Параметр пропуска лишних прав меняет правила отзыва.
ValidJFN · JSON: не сохраняетсялогическоеСравниваетсяСостояние компиляции приёмника- Назначение
- Статус ALL_OBJECTS.STATUS. В описании из набора true; действительный статус считывается только у приёмника.
- При переносе:
- Valid=false у приёмника даёт Update JFN даже при одинаковом Body. В YAML/JSON не сохраняется. CREATE OR REPLACE может оставить функцию невалидной; финализация перекомпилирует схему и относит оставшиеся ошибки к исходам команд. Это не отдельная команда исправить программную логику.
DependenciesJFN · JSON: dependenciesсписок / nullДля порядкаИспользуемые объекты Oracle- Назначение
- Адреса локальных опор из ALL_DEPENDENCIES. Каждый содержит TypeCode и Name, но не определение цели.
- При переносе:
- Читаются ссылки на JTB, JVW, JFN, JPR, JPG, JSQ и JSY; синоним разворачивается также до цели. Системные, удалённые и неподдерживаемые объекты исключены. Список не участвует в сравнении текста; сам по себе не создаёт Update. Null и [] не включают скан PL/SQL. Зависимости совпавшей функции тоже учитываются в порядке команд её потребителей, если её описание есть в наборе.
OwnerJFN · JSON: не сохраняетсявсегда nullСлужебноеОтдельного владельца нет- Назначение
- Владелец Oracle уже задан полем Schema. Вычисляемое Owner служит общей модели прав.
- При переносе:
- Не задаётся и не сохраняется, null опускается. Отдельного ALTER OWNER здесь нет; изменение Schema адресует другой объект. Соответствие получателей прав не переносит функцию в другую схему.
Право на функцию · JFP.Grant / JFN.Grant3 поля
GranteeJFP.Grant / JFN.Grant · JSON: granteeстрокаЧасть ключаПолучатель- Назначение
- Роль, пользователь или PUBLIC. Это получатель права, а не владелец и не автор выдачи.
- При переносе:
- Вместе с Privilege определяет ключ. Смена получателя даёт отзыв прежнему и выдачу новому. PUBLIC приводится к верхнему регистру; обычные имена ролей нормализуются по СУБД и правилам соответствия ролей. Роль должна существовать: Holkas её не создаёт.
PrivilegeJFP.Grant / JFN.Grant · JSON: privilegeстрокаЧасть ключаРазрешённое действие- Назначение
- EXECUTE позволяет вызывать функцию. В Oracle каталог может также дать DEBUG. Это не право SELECT на результат функции.
- При переносе:
- Код приводится к верхнему регистру. Смена привилегии — Delete старой и Create новой. PostgreSQL применяет каждую команду ко всем сигнатурам имени. Само EXECUTE не даёт вызывающему прав на таблицы тела при исполнении с правами вызывающего.
WithGrantOptionJFP.Grant / JFN.Grant · JSON: withGrantOptiontrue / nullСравниваетсяМожно передать право дальше- Назначение
- True разрешает получателю выдавать привилегию другим; null означает обычное право. False нормализуется в null.
- При переносе:
- При прежнем ключе изменение даёт Update права. PostgreSQL снимает GRANT OPTION отдельно; Oracle для снятия отзывает и выдаёт обычное право. Отзыв переданного дальше права защищён от скрытого каскада. При повторах одного ключа PostgreSQL оставляет true, только если оно есть у всех имеющихся записей этого ключа.
Адрес опоры Oracle · Dependencies · JFN2 поля
TypeCodeDependencies · JFN · JSON: typeCodeстрокаДля порядкаТип используемого объекта- Назначение
- Код физического объекта Holkas: например JTB для таблицы или JPG для пакета Oracle.
- При переносе:
- Вместе с Name адресует ожидание Create/Update. Не подменяйте его кодом CLS: регистрация класса не создаёт таблицу или пакет. Изменение этой ссылки не переписывает обращения в Body.
NameDependencies · JFN · JSON: nameстрокаДля порядкаПолный адрес опоры- Назначение
- Схема и имя, например PARUS.UDO_UTIL. Это ссылка на другой объект.
- При переносе:
- Используется для порядка и проверки покрытия зависимости. Сохраняйте адрес из экспорта. Динамический SQL и обращения через удалённую базу не становятся локальными зависимостями простой правкой этого списка.
Команды плана
Четыре кода: определение и права каждой СУБД. У целой функции только Create/Update, у права также Delete. Перегрузки, аргументы и позиции отдельных команд не имеют.
PostgreSQL · JFP2 кода
JFPФункция PostgreSQL
Create исполняет Body, назначает владельца и устанавливает исходные права. Update сначала выполняет Body через CREATE OR REPLACE; только при 42P13/42723 откатывает пробу и удаляет прежние сигнатуры перед повтором. Затем убирает не затронутые Body перегрузки, назначает владельца всем оставшимся и приводит права к исходному общему набору. Всё это внутри транзакции команды. Разница только прав даёт только Grant. Delete целой функции по отсутствию в наборе не строится.
Ключ: Схема.Функция
JFP.GrantПраво · PostgreSQL
Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает отсутствующее право. Параметр пропуска лишних прав может сохранить лишние выдачи и возможность их передачи. Команда применяется к каждой сигнатуре этого имени. У новой функции может быть Delete PUBLIC:EXECUTE, снимающий умолчание PostgreSQL.
Ключ: Схема.Функция|Получатель:Привилегия
Oracle · JFN2 кода
JFNФункция Oracle
Create/Update переключает CURRENT_SCHEMA и выполняет CREATE OR REPLACE с Body. Update возникает при разнице текста или Valid=false у приёмника. Права остаются отдельными Grant, замена определения сохраняет прежние выдачи. DDL фиксируется Oracle; оставшаяся невалидность выясняется при финализации схемы. Delete целой функции по отсутствию в наборе не строится.
Ключ: Схема.Функция
JFN.GrantПраво · Oracle
Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает отсутствующее право. Параметр пропуска лишних прав может сохранить лишние выдачи и возможность их передачи. При ORA-04063 выдача откладывается до перекомпиляции; финальный этап повторяет её и проверяет оставшиеся ошибки. Снятие GRANT OPTION требует отзыва и повторной выдачи.
Ключ: Схема.Функция|Получатель:Привилегия
Ограничения и что с ними делать
Update PostgreSQL может удалить перегрузку
В приёмнике есть udo_f_amount(numeric) и udo_f_amount(text). В Body из набора осталось только определение числового варианта. План покажет одну Update JFP: после успешной замены она удалит строковый вариант. Строки Delete JFP для него не будет.
Перед применением смотрите полный diff Body, включая удалённые определения. Если строковый вариант нужен, сохраните его в определении из набора. Отсутствие всей JFP в выбранном наборе, напротив, не даёт команды её удаления.
Замена на месте и запасной путь DROP → CREATE
Update сначала исполняет Body без предварительного DROP. При ошибках PostgreSQL 42P13 или 42723, например при несовместимой смене результата, Holkas откатывает пробу к точке сохранения, удаляет все прежние сигнатуры имени и повторяет создание. Другие ошибки этот путь не включают.
Удаление выполняется без CASCADE. Если представление использует udo_f_amount(text), убрать эту перегрузку или пересоздать её может не позволить PostgreSQL. Holkas не пересоздаёт потребителей автоматически. Заранее переведите их на оставшуюся реализацию отдельным согласованным изменением.
Определение, очистка перегрузок, владелец и исходные права входят в транзакцию корневой команды PostgreSQL. При обычном отказе её изменения откатываются; ранее исполненные команды обычного переноса остаются. В режиме одной транзакции PostgreSQL отказ откатывает весь план.
Типы перегрузок ищутся эвристически
У JFP нет переносимого поля Dependencies. Holkas эвристически ищет типы аргументов, результата и переменных DECLARE в Body; это не полноценный SQL-парсер. Body содержит все перегрузки, и заголовок каждой читается отдельно.
SQL-функция ждёт таблицу из своего запроса только в одном наборе
Функция на LANGUAGE sql читает новую таблицу или новую колонку. PostgreSQL проверяет такое тело уже при CREATE. Включите таблицу и функцию в один набор: таблица и её колонки создаются раньше. Если таблицы нет ни в наборе, ни в приёмнике, план об этом не предупредит — проверьте запрос функции сами. Функция на PL/pgSQL создаётся и без таблицы; ошибку покажет первый вызов.
Oracle: невалидная функция и частичное применение
CREATE OR REPLACE может сохранить текст с ошибками компиляции. В конце переноса Holkas перекомпилирует схемы, повторяет отложенные выдачи прав и связывает оставшиеся ошибки ALL_ERRORS с исходами команд. Совпавший Body при невалидном приёмнике также даёт Update JFN.
Oracle фиксирует DDL средствами СУБД: отката всей замены, подобного PostgreSQL, нет. Например, текст уже заменён, а выдача права затем отказала — прежний текст не восстановится. Исправляйте конкретную причину и стройте новый план по фактическому состоянию; успешная запись определения не доказывает работу вызова.
Oracle: многострочные литералы переносятся точно
Вне литералов Holkas не считает различием хвостовые пробелы строк, CRLF вместо LF и пустые строки по краям: такое форматирование не создаёт Update. Текст в кавычках сохраняется точно. Если функция возвращает строку с двумя значащими пробелами перед LF, в приёмнике они остаются на месте. Пример исходного фрагмента — между A и переводом строки два обычных пробела:
RETURN 'A
B';То же относится к q'[…]', CR внутри литерала и идентификаторам в двойных кавычках.
Роли и полномочия SECURITY DEFINER
Получатели и явно заданный владелец PostgreSQL должны существовать и быть доступны учётной записи переноса. Соответствие ролей меняет имена получателей, «Замена владельцев» — только владельца; роли эти параметры не создают. Для SECURITY DEFINER владелец определяет полномочия кода: план показывает соответствующую заметку.
JFP без владельца
Файл функции, где поле Owner пропущено или пустое, не переносится: план не строится, а отказ называет объект. Приёмник не меняется. Выгрузите объект из базы заново или впишите нужную роль в Owner.
Лишние права и защита от каскадного отзыва
По умолчанию лишняя выдача и лишний GRANT OPTION отзываются. Параметр «Пропускать лишние права в приёмнике» сохраняет их. Если получатель уже передал право другим, Holkas защищает от скрытого каскадного отзыва; сначала согласуйте судьбу переданных прав либо снимите команду отзыва.
Регистрация функции PostgreSQL в Парусе
После применения функция регистрируется в справочнике конвертера Паруса, если доступны его каталог и функция регистрации и схема совпадает с TARGET_SCHEMA. Если у имени несколько перегрузок или оно занято и функцией, и процедурой, регистрация пропускается: Парус сводит их к одному номеру. При нескольких определениях JFP на строке плана есть заметка.
Отдельная проверка плана предупреждает о перегрузках, которые Парус не примет в пользовательской процедуре или отчёте. Это проверка конкретного потребителя, а не запрет всех перегрузок PostgreSQL. Успешное создание JFP не гарантирует её привязку в КОР. Если такой потребитель нужен, подготовьте отдельное имя с одной допустимой сигнатурой.
Регистрация не восстанавливает все результаты конвертации с Oracle: вычисленные зависимости, права и вложенные функции. Бинарный образ конвертера Holkas не пересобирает.
Windows-клиент Паруса: пересчёт и функция описания словаря
В сохранённых опытах на Парусе 27.08.2026 новая JFP выполнялась в базе и веб-клиенте, но пересчёт формы и «Функция описания» словаря в Windows-клиенте выдавали OCI_INVALID_HANDLE. Методы действий, созданные тем же способом, работали. Решением владельца это учитывается как ограничение Паруса, не исправленный дефект Holkas.
Вероятная причина связана с бинарным образом конвертера; пересборка PPCRebuild не проверялась и не является подтверждённым решением. Проверенный обход для этих двух путей: поставляемая Парусом функция пересчёта либо статический вызов словаря. Другие редакции клиента в этом опыте не проверялись.
SQL-файл имеет другой способ применения
Экспорт SQL сохраняет полное определение, права и явно заданного владельца PostgreSQL. Последнее определение получает завершающий разделитель; блоки DO назначают владельца и права каждой найденной сигнатуре имени и снимает EXECUTE у PUBLIC, если его нет в правах из набора. Oracle-файл содержит ALTER SESSION, CREATE OR REPLACE, разделитель / и выдачи прав, а в конце — пересборку схемы, как после переноса в базу.
Этот файл не строит diff с будущей базой, не удаляет исчезнувшие перегрузки и не повторяет несовместимую замену через запасной DROP → CREATE. Он также не воспроизводит точный отзыв всех лишних прав приёмника: проверьте SQL и способ исполнения своим клиентом отдельно.
Если в одном файле с функцией есть таблица, триггер которой её вызывает, триггер записан после функции. Файл, выгруженный версией 0.1.35 или более ранней, мог содержать таблицу с триггером раньше функции, и psql останавливался на «function … does not exist»: выгрузите такой набор заново. Настоящая выгрузка и применение SQL →
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше.
Учебная функция принимает строку новой таблицы: r parus.udo_t_request. После создания пустой оболочки таблицу нужно наполнить колонками.
Create TBP.ColCreate JFPНиже 20 правил: собственные опоры, права, непосредственные потребители функции и скрипты автора. Это число правил справки, а не число рёбер каждого плана.
Типы PostgreSQLПравил: 4
Create / Update TBP, JVP, CTP→Create / Update JFPКогда: Скан Body распознал тип аргумента, результата (в том числе колонки RETURNS TABLE) или переменной DECLARE в любой перегрузке.
Кандидат без схемы проверяется в схеме функции и parus; самоссылка исключается. Если перечень источника подтверждает объект, это настоящая зависимость; иначе ребро только упорядочивает совпавшие команды. Заголовок каждой перегрузки читается отдельно.
Create / Update TBP, JVP, JFP, JPP, SQP, CTP→Create / Update JFPКогда: Функция написана на LANGUAGE sql.
PostgreSQL разбирает такое тело уже при CREATE, поэтому Holkas сканирует его целиком, как текст представления: таблица из запроса и её колонки создаются раньше. Ребро только упорядочивает команды набора: без таблицы в наборе план о ней не предупреждает. Тело PL/pgSQL так не сканируется — оно проверяется при первом вызове.
Create / Update TBP.Col→Create / Update JFPКогда: Распознан TBP, его описание есть в наборе.
Дождаться всех колонок после пустой оболочки Create TBP. Ожидания частей только для порядка: у совпавшей колонки команды может не быть.
Create / Update CTP.Item→Create / Update JFPКогда: Распознан CTP, его описание есть в наборе.
Дождаться наполнения оболочки составного типа. Эти рёбра также только упорядочивают существующие команды.
Права после определенияПравил: 1
Create / Update JFP или JFN→Create / Update / Delete того же *.GrantКогда: Обе команды присутствуют для одной функции.
Права выполняются после определения. PostgreSQL корневой командой устанавливает исходный общий набор прав, от которого считался план; более ранняя команда права была бы перезаписана.
Каталог OracleПравил: 3
Create / Update JTB, JVW, JFN, JPR, JPG, JSQ, JSY→Команда JFN или JFN.Grant, кроме DeleteКогда: В Dependencies функции сохранён адрес опоры.
Ожидания по Dependencies получают все команды функции, кроме Delete, — в том числе команды прав. Синоним и конечная цель могут дать отдельные рёбра. Наличие ссылки не создаёт команду изменения неизменившейся опоры.
Create / Update дальнейшей опоры Oracle→Команда потребителя, кроме DeleteКогда: Прямая подтверждённая ссылка ведёт к совпавшей функции, её описание с Dependencies доступно в наборе.
Цепочка зависимостей продолжается через объект, который сам не меняется. Например, процедура ждёт пакет, используемый совпавшей функцией. Без описания промежуточного объекта цепочка не восстанавливается.
Create / Update JTB.Col→Команда потребителя Oracle, кроме DeleteКогда: Зависимость проходит к JTB и в плане есть реальные команды её колонок.
Уже существующая таблица может получать новые колонки: одного ожидания её корня недостаточно. Учитываются реальные команды, без требования создать совпавшие колонки.
Непосредственные потребители функцииПравил: 11
Create / Update JFP→Create / Update JVPКогда: Каталог Dependencies представления ссылается на функцию; у старого файла без списка её имя найдено сканом.
Каталог даёт настоящую зависимость. Запасной скан JVP только упорядочивает совпавшие команды; при Dependencies=[] он выключен.
Create / Update JFN→Команда другого объекта Oracle, кроме DeleteКогда: Dependencies потребителя (JFN/JPR/JPG/JVW, триггер JTB.Trg) называет функцию.
Та же общая обработка каталога применяется к непосредственному потребителю. Местные зависимости Oracle не выводятся из произвольного текста функции.
Create / Update JFP→Create / Update TBP.TrgКогда: FunctionName триггера называет эту PostgreSQL-функцию.
Триггер использует самостоятельную JFP; выбор таблицы сам по себе её не включает. Сначала подготовить реализацию триггера.
Create / Update JFP или JFN→Create / Update METКогда: Имя реализации метода ссылается на функцию.
Для MethodType=1 без Package: JFP на PostgreSQL, JFN на Oracle. Метод пакета Oracle ждёт JPG; на PostgreSQL — JFP вида parus.пакет$имя. Для процедурного метода PostgreSQL JFP/JPP — альтернативы, достаточно подходящей реализации.
Create / Update JFP или JFN→Create / Update MET.ParamКогда: Параметр создаётся/меняется, а корень MET не получает Create.
Параметр сам ждёт реализацию теми же правилами, даже если реквизиты метода совпали. При Create MET он получает это ожидание через родителя.
Create / Update JFP→Create / Update REPКогда: StoredProcedure отчёта называет функцию PostgreSQL.
Сначала реализация, затем запись пользовательского отчёта. JPP может закрыть альтернативную процедурную ссылку. На Oracle эта ссылка ведёт к JPR, не JFN.
Create / Update JFP→Create / Update REP.ParamКогда: У параметра отчёта заполнен NameParameterProcedure.
Парус сверяет имя аргумента с реализацией; параметр ждёт её и Update REP. Наличие функции ещё не гарантирует допустимость перегрузок для отчёта.
Create / Update JFP→Create / Update PCEКогда: ProcedureName пользовательской процедуры заполнен и называет эту реализацию PostgreSQL.
Подготовить физическую подпрограмму перед записью её описания в Парусе. JFP/JPP выступают альтернативами; параметры PCE собственного такого ребра не добавляют.
Create / Update JFP→Create / Update MECКогда: Условие вызова метода содержит распознанную процедуру, исполняемую в PostgreSQL.
Подготовить процедуру условия. Используется разбор CondType/Settings, а не поиск любого имени в XML; JPP — альтернативная цель.
Create / Update JFP или JFN→Create / Update CLS.VFКогда: FormData либо FormDataExt называет функцию описания словаря.
Сначала функция нужной СУБД, затем форма класса. При null нового текста сканируется прежний. Формы REP/PCE этим общим сканером не обследуются.
Create / Update JFP→Create / Update CLS.VFКогда: XML формы класса содержит распознанную процедуру пересчёта; приёмник PostgreSQL.
Подготовить пересчёт до формы. JPP — альтернатива; на Oracle процедура пересчёта адресуется JPR. Это отдельная ссылка от функции описания словаря.
Скрипты автораПравил: 2
SCR Before→JFP / JFN и их GrantКогда: БД-приёмник выполняет скрипт до этой функции или всего переноса.
Скрипт встаёт до команд своей области. Без команд области он в исполняемый план не попадает.
JFP / JFN и их Grant→SCR AfterКогда: Та же область, время After.
Выполнить скрипт после команд функции и прав; это не автоматический разбор SQL-зависимостей тела.
Что этот граф не гарантирует
Ребро помогает порядку, выбору и проверке недостающих известных опор. Оно не означает безусловного включения всех вызываемых функций в первоначальную выгрузку. Разрешение зависимостей плана и раскрытие выбранного состава — разные действия.
Скан JFP не строит полный граф SQL: у функции на PL/pgSQL запрос к таблице в теле не даёт ожидания. У функции на LANGUAGE sql тело сканируется целиком — у каждой такой перегрузки, даже если первая написана на PL/pgSQL, но таблицу, не включённую в набор, план не предлагает. Нет общего обратного порядка «все потребители перед DROP старой перегрузки»: DROP находится внутри Update JFP, и зависимость PostgreSQL может его заблокировать. Разбор недостающих зависимостей →
Как функция хранится в файлах
Начните с FunctionPostgres/ или FunctionOracle/. Ниже учебные имена parus.udo_f_amount и PARUS.UDO_F_AMOUNT. Все перегрузки PostgreSQL находятся в одном Body, без файлов на каждую сигнатуру. Права и адреса зависимостей Oracle вложены в собственный файл функции.
Git
YAMLFunctionPostgres/parus.udo_f_amount.yamlОпределение в Body — обычный текст. Поля Schema, Name, Grants, Owner; у Oracle — необязательный Dependencies.
При чтении YAML описание восстанавливается функции. Метаданные репозитория — в .holkas.S3
JSON в ZIPFunctionPostgres/parus.udo_f_amount.jsonBody записан строкой body, не Base64; права в grants. ZIP сохраняется в S3.
manifest.json перечисляет JFP/JFN; при загрузке читается соответствующий JSON.Файл пакета
JSON в ZIPFunctionPostgres/parus.udo_f_amount.jsonСкачиваемый ZIP с тем же объектным JSON функции и вложенным grants.
При загрузке состав берётся из manifest.json, описание восстанавливается.Для Oracle пути соответственно FunctionOracle/PARUS.UDO_F_AMOUNT.yaml и FunctionOracle/PARUS.UDO_F_AMOUNT.json. В оглавлении ZIP: {"typeCode":"JFP","name":"parus.udo_f_amount"} либо {"typeCode":"JFN","name":"PARUS.UDO_F_AMOUNT"}. Манифест также содержит версию формата и СУБД — устройство пакета. Небезопасные символы имён кодируются, например / как %2F; имя объекта внутри от этого не меняется.
Запись и чтение ZIP для S3 и для файла пакета проверены отдельно, в том числе перекрёстно: для JFP/JFN устройство совпадает. Это не обобщение на все типы Holkas. Valid Oracle не сохраняется; вычисляемый Owner всегда null и опущен. Необязательные null опускаются, пустые списки сохраняются. Текущий формат не использует прежнюю Base64-упаковку программного текста.
Одни поля в YAML и JSON · PostgreSQL
Полное учебное описание одной функции, использованное в локальной проверке записи и обратного чтения. Базы и роли для него не создаются. Язык и поведение определяются Body; > в YAML складывает строки по правилам YAML, при обратном чтении исходный текст восстанавливается. При правке многострочного кода безопаснее сохранять разметку полного экспорта.
Git — FunctionPostgres/parus.udo_f_amount.yaml
Schema: parus
Name: udo_f_amount
Body: >
CREATE OR REPLACE FUNCTION parus.udo_f_amount(n numeric)
RETURNS numeric
LANGUAGE sql
AS $function$SELECT n * 1.2$function$
Grants:
- Grantee: PUBLIC
Privilege: EXECUTE
- Grantee: reader
Privilege: EXECUTE
WithGrantOption: true
Owner: parus
S3 и «Файл пакета» — FunctionPostgres/parus.udo_f_amount.json
{
"schema": "parus",
"name": "udo_f_amount",
"body": "CREATE OR REPLACE FUNCTION parus.udo_f_amount(n numeric)\n RETURNS numeric\n LANGUAGE sql\nAS $function$SELECT n * 1.2$function$\n",
"grants": [
{ "grantee": "PUBLIC", "privilege": "EXECUTE" },
{ "grantee": "reader", "privilege": "EXECUTE", "withGrantOption": true }
],
"owner": "parus"
}
Oracle: текст и адреса зависимостей
Фрагмент объектного JSON с полной учебной функцией и одной ссылкой. Для краткости опущен обязательный Grants: это не готовый файл загрузки. У настоящего экспорта он присутствует, даже когда равен [].
{
"schema": "PARUS",
"name": "UDO_F_AMOUNT",
"body": "FUNCTION UDO_F_AMOUNT(N NUMBER) RETURN NUMBER IS\nBEGIN\n RETURN UDO_UTIL.AMOUNT(N);\nEND;",
"dependencies": [
{ "typeCode": "JPG", "name": "PARUS.UDO_UTIL" }
]
}
Учебная функция вызывает UDO_UTIL.AMOUNT; пакет назван в Dependencies, но его определение не вложено в JFN. В настоящем экспорте Dependencies получают из каталога исходной базы; не добавляйте произвольные адреса ради «полноты». В YAML те же поля называются Body, Dependencies, TypeCode и Name.
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета, перенести с теста на рабочую базу.
Основа справки: текущие модель, каталоги, сравнение, граф команд, исполнители и сериализаторы Holkas 0.1.30; сохранённые результаты изучения КОР Парус 8 на редакции 27.08.2026. Сверено 9 ноября 2026. Имена и SQL на странице — учебные. Запись и чтение файлов, планы и преобразователи проверены локально; новый перенос в PostgreSQL/Oracle и новый запуск клиентов Паруса не выполнялись.