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

Справочник / объект

Процедура базы

Тип объекта в Holkas: JPP

PostgreSQL

Тип объекта в Holkas: JPR

Oracle

В командной строке: --object JPP:parus.udo_p_amount или --object JPR:PARUS.UDO_P_AMOUNT · как задать состав в CLI

Процедуры доработки КОР Парус 8: все поля PostgreSQL и Oracle, перегрузки, права, зависимости, команды и хранение в Git и ZIP.

← Все объекты
На этой странице

Программный код базы · PostgreSQL и Oracle

Процедура хранит исполняемую программу под именем в базе. Например, доработка КОР Парус 8 вызывает процедуру для расчёта суммы: перенос меняет её определение, а новые суммы вычисляются при последующих вызовах.

АдресJPP / JPR + Схема.Имя
PostgreSQLВсе перегрузки имени
OracleОтдельно стоящая процедура

Процедура и её перегрузки

Тип объекта в Holkas: JPP — процедура PostgreSQL, JPR — процедура Oracle. Holkas переносит определение с входными и выходными аргументами, настройки и права. PL/SQL автоматически не переводится в PL/pgSQL: для другой СУБД нужна отдельная реализация.

В PostgreSQL несколько процедур могут иметь одно имя, но разные входные аргументы. Такие варианты называют перегрузками. Например, учебная parus.udo_p_amount(numeric) принимает число, а parus.udo_p_amount(text) — строку. Имя с типами входных аргументов называют сигнатурой. Это разные способы вызвать процедуру, а не история её версий.

В Holkas оба варианта — один объект JPP · parus.udo_p_amount. Выбор включает все определения этого имени. Выбрать только вариант (numeric) как отдельную JPP нельзя. Права и владелец также представлены одним общим набором на имя.

Процедура PostgreSQL вызывается через CALL; функция JFP — другой физический тип. Для большинства процедур Паруса на PostgreSQL реализацией служит именно функция. Holkas различает их по каталогу pg_proc.prokind: p для JPP, f для JFP, а не по префиксу имени. Реализация JPP тоже может закрыть процедурную ссылку Паруса; это не обещание её работы во всех клиентах и местах вызова.

Входной аргумент IN передаёт значение в процедуру, OUT отдаёт значение наружу, INOUT делает и то и другое. Это режимы аргументов внутри Body, а не дочерние объекты Holkas. Для адресации прав и удаления конкретных сигнатур Holkas для PostgreSQL сохраняет явные режимы IN/OUT, а не подставляет один список типов.

В Oracle отдельно стоящая процедура одна на имя. Перегрузки подпрограмм внутри пакета относятся к пакету Oracle JPG. Настройка метода класса MET, описание пользовательской процедуры PCE и запись реестра CLO — отдельные объекты: выбор процедуры не создаёт их. CLO может хранить копию исходного текста, но перенос этой записи сам DDL не выполняет.

Что входит в перенос

Использует, но не включает внутрь: таблицы, типы и другие подпрограммы. У Oracle адреса опор хранятся в Dependencies; у PostgreSQL кандидаты типов ищутся в Body. Определения опор выбираются отдельно.
Аргументы и перегрузки находятся в определении самой процедуры, без собственных файлов и команд. Для Oracle — её реквизиты. Права вложены в объект, но меняются отдельными командами.

У процедуры нет папки каталога Паруса: ни имя узла, ни полный путь с родителями не переносятся и не создаются. Schema — пространство имён СУБД. Каталоги ProcedurePostgres/ProcedureOracle в Git и ZIP — раскладка файлов экспорта.

Справочник полей

17 полей · 4 группы

5 свойств PostgreSQL, 7 Oracle, 3 поля права и 2 поля адреса зависимости. Имена с большой буквы соответствуют YAML; в JSON первая буква маленькая. Служебные Valid и Owner Oracle учтены отдельно.

Как читать обозначения

Ключ задаёт сопоставление, «Сравнивается» — обнаруживаемую разницу, «По элементам» — отдельные команды прав. Dependencies служит порядку и проверке ссылок; сам список не изменяет программу. Обнаруженное различие не гарантирует, что СУБД разрешит запись.

Процедура PostgreSQL · JPP5 полей
SchemaJPP · JSON: schemaстрокаЧасть ключаСхема процедуры
Назначение
Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle.
При переносе:
Вместе с Name задаёт адрес объекта. Смена схемы означает другое сопоставление, а не перемещение старой процедуры. Схему или пользователя Oracle команда не создаёт. У PostgreSQL Schema и Name должны согласовываться с заголовками Body; Holkas исполняет этот текст, а не строит заголовки из двух полей.
NameJPP · JSON: nameстрокаЧасть ключаИмя без схемы
Назначение
Например udo_p_amount. Типы аргументов здесь не указываются.
При переносе:
При отсутствии такого адреса будет Create; старое имя не переименовывается и не удаляется. В PostgreSQL адрес охватывает все перегрузки имени, а не одну сигнатуру. В Oracle подпрограммы внутри пакета относятся к JPG, а не JPR.
BodyJPP · JSON: bodyстрокаСравниваетсяПолное определение всех перегрузок
Назначение
CREATE OR REPLACE PROCEDURE из pg_get_functiondef: аргументы с режимами IN/OUT/INOUT, язык, свойства и программный текст. Определения одного имени соединены в порядке сигнатур.
При переносе:
Изменение даёт одну Update JPP на весь объект. CRLF/LF равны; пробелы и иное написание кода могут дать различие. Update сначала исполняет текст на месте, при 42P13/42723 пробует пересоздание; затем удаляет прежние перегрузки, которых текст не затронул. Аргументы и SECURITY DEFINER — часть Body, отдельных полей для них нет.
GrantsJPP · JSON: grantsсписокПо элементамПрава на процедуру
Назначение
Привилегии получателей. Для PostgreSQL список общий для всех перегрузок, а не отдельный для каждой.
При переносе:
Сопоставляются по Grantee:Privilege, порядок записей несущественен. Create выдаёт, Delete отзывает, Update меняет GRANT OPTION. [] означает пустой список прав и может породить отзывы. Для новой процедуры PostgreSQL отсчёт идёт от EXECUTE у PUBLIC: если его нет в Grants, появляется Delete JPP.Grant. Параметр пропуска лишних прав меняет правила отзыва.
OwnerJPP · JSON: ownerстрокаСравниваетсяРоль-владелец всех перегрузок
Назначение
Отдельна от Schema. При чтении Holkas выбирает минимальное имя владельца среди перегрузок; различающиеся владельцы не представляются отдельно.
При переносе:
Явное имя назначается каждой перегрузке; роль должна существовать, а перенос — иметь полномочия её назначить. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется.
Процедура Oracle · JPR7 полей
SchemaJPR · JSON: schemaстрокаЧасть ключаСхема процедуры
Назначение
Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle.
При переносе:
Вместе с Name задаёт адрес объекта. Смена схемы означает другое сопоставление, а не перемещение старой процедуры. Схему или пользователя Oracle команда не создаёт. У PostgreSQL Schema и Name должны согласовываться с заголовками Body; Holkas исполняет этот текст, а не строит заголовки из двух полей.
NameJPR · JSON: nameстрокаЧасть ключаИмя без схемы
Назначение
Например udo_p_amount. Типы аргументов здесь не указываются.
При переносе:
При отсутствии такого адреса будет Create; старое имя не переименовывается и не удаляется. В PostgreSQL адрес охватывает все перегрузки имени, а не одну сигнатуру. В Oracle подпрограммы внутри пакета относятся к JPG, а не JPR.
BodyJPR · JSON: bodyстрокаСравниваетсяИсходный текст отдельно стоящей процедуры
Назначение
PROCEDURE с аргументами IN/OUT/IN OUT, настройками и телом из ALL_SOURCE, в порядке LINE. Заголовок обычно без схемы; CREATE OR REPLACE в это поле не входит.
При переносе:
Применение переключает CURRENT_SCHEMA и добавляет CREATE OR REPLACE к Body. Разница даёт Update JPR; Вне литералов CRLF/LF равны, а хвостовые пробелы строк и пустые крайние строки различием не считаются; текст литералов переносится точно. Значения аргументов и результат вызова при переносе не вычисляются.
GrantsJPR · JSON: grantsсписокПо элементамПрава на процедуру
Назначение
Привилегии получателей. Для PostgreSQL список общий для всех перегрузок, а не отдельный для каждой.
При переносе:
Сопоставляются по Grantee:Privilege, порядок записей несущественен. Create выдаёт, Delete отзывает, Update меняет GRANT OPTION. [] означает пустой список прав и может породить отзывы. Для новой процедуры PostgreSQL отсчёт идёт от EXECUTE у PUBLIC: если его нет в Grants, появляется Delete JPP.Grant. Параметр пропуска лишних прав меняет правила отзыва.
ValidJPR · JSON: не сохраняетсялогическоеСравниваетсяСостояние компиляции приёмника
Назначение
Статус ALL_OBJECTS.STATUS. В описании из набора true; действительный статус считывается только у приёмника.
При переносе:
Valid=false у приёмника даёт Update JPR даже при одинаковом Body. В YAML/JSON не сохраняется. CREATE OR REPLACE может оставить процедуру невалидной; финализация перекомпилирует схему и относит оставшиеся ошибки к исходам команд. Это не отдельная команда исправить программную логику.
DependenciesJPR · JSON: dependenciesсписок / nullДля порядкаИспользуемые объекты Oracle
Назначение
Адреса локальных опор из ALL_DEPENDENCIES. Каждый содержит TypeCode и Name, но не определение цели.
При переносе:
Читаются ссылки на JTB, JVW, JFN, JPR, JPG, JSQ и JSY; синоним разворачивается также до цели. Системные, удалённые и неподдерживаемые объекты исключены. Список не участвует в сравнении текста; сам по себе не создаёт Update. Null и [] не включают скан PL/SQL. Зависимости совпавшей процедуры тоже учитываются в порядке команд её потребителей, если её описание есть в наборе.
OwnerJPR · JSON: не сохраняетсявсегда nullСлужебноеОтдельного владельца нет
Назначение
Владелец Oracle уже задан полем Schema. Вычисляемое Owner служит общей модели прав.
При переносе:
Не задаётся и не сохраняется, null опускается. Отдельного ALTER OWNER здесь нет; изменение Schema адресует другой объект. Соответствие получателей прав не переносит процедуру в другую схему.
Право на процедуру · JPP.Grant / JPR.Grant3 поля
GranteeJPP.Grant / JPR.Grant · JSON: granteeстрокаЧасть ключаПолучатель
Назначение
Роль, пользователь или PUBLIC. Это получатель права, а не владелец и не автор выдачи.
При переносе:
Вместе с Privilege определяет ключ. Смена получателя даёт отзыв прежнему и выдачу новому. PUBLIC приводится к верхнему регистру; обычные имена ролей нормализуются по СУБД и правилам соответствия ролей. Роль должна существовать: Holkas её не создаёт.
PrivilegeJPP.Grant / JPR.Grant · JSON: privilegeстрокаЧасть ключаРазрешённое действие
Назначение
EXECUTE позволяет вызывать процедуру. В Oracle каталог может также дать DEBUG. Вызов не запускается самим переносом определения.
При переносе:
Код приводится к верхнему регистру. Смена привилегии — Delete старой и Create новой. PostgreSQL применяет каждую команду ко всем сигнатурам имени. Само EXECUTE не даёт вызывающему прав на таблицы тела при исполнении с правами вызывающего.
WithGrantOptionJPP.Grant / JPR.Grant · JSON: withGrantOptiontrue / nullСравниваетсяМожно передать право дальше
Назначение
True разрешает получателю выдавать привилегию другим; null означает обычное право. False нормализуется в null.
При переносе:
При прежнем ключе изменение даёт Update права. PostgreSQL снимает GRANT OPTION отдельно; Oracle для снятия отзывает и выдаёт обычное право. Отзыв переданного дальше права защищён от скрытого каскада. При повторах одного ключа PostgreSQL оставляет true, только если оно есть у всех имеющихся записей этого ключа.
Адрес опоры Oracle · Dependencies · JPR2 поля
TypeCodeDependencies · JPR · JSON: typeCodeстрокаДля порядкаТип используемого объекта
Назначение
Код физического объекта Holkas: например JTB для таблицы или JPG для пакета Oracle.
При переносе:
Вместе с Name адресует ожидание Create/Update. Не подменяйте его кодом CLS: регистрация класса не создаёт таблицу или пакет. Изменение этой ссылки не переписывает обращения в Body.
NameDependencies · JPR · JSON: nameстрокаДля порядкаПолный адрес опоры
Назначение
Схема и имя, например PARUS.UDO_UTIL. Это ссылка на другой объект.
При переносе:
Используется для порядка и проверки покрытия зависимости. Сохраняйте адрес из экспорта. Динамический SQL и обращения через удалённую базу не становятся локальными зависимостями простой правкой этого списка.
Grants: пустой список и неполный файл

При чтении JSON из обоих ZIP поле Grants обязательно: пропуск поля или null отклоняется, [] задаёт пустой список прав. Dependencies Oracle необязателен. При чтении YAML пропуск Grants допускается и даёт null; это не корректное пустое состояние для плана. Сохраняйте полный экспорт.

Пустое определение процедуры

Пустой Body не означает «оставить прежний текст» и не создаёт пустую программу. PostgreSQL передаёт Body на выполнение без подстановки прежнего определения; Oracle получает CREATE OR REPLACE без определения и отказывает. Не используйте null или пустую строку для сохранения существующей реализации.

Один владелец и один набор прав на все перегрузки PostgreSQL

При чтении Holkas выбирает минимальное имя владельца и объединяет выдачи разных сигнатур по ключу получателя и привилегии. Если один ключ встретился несколько раз, GRANT OPTION сохраняется лишь при true у всех этих записей; отсутствующая на другой сигнатуре выдача не добавляет запись false.

Например, reader имеет EXECUTE только на варианте (numeric), но не на (text). В экспорт попадёт одна выдача reader:EXECUTE. На новом приёмнике команда даст её обоим вариантам; Update тела тоже приводит права всех вариантов к общему прежнему набору. Различающиеся владельцы также станут одним владельцем. Формат не сохраняет индивидуальную политику каждой сигнатуры: для таких процедур заранее согласуйте общий доступ либо используйте отдельные имена и отдельное управление правами.

Неявные собственные права владельца не являются отдельными выдачами. У PostgreSQL отсутствие ACL в каталоге означает умолчание EXECUTE у PUBLIC и владельца, а не отсутствие доступа.

Команды плана

Четыре кода: определение и права каждой СУБД. У целой процедуры только Create/Update, у права также Delete. Перегрузки, аргументы и позиции отдельных команд не имеют.

PostgreSQL · JPP2 кода
JPP
CreateUpdate

Процедура PostgreSQL

Create исполняет Body, назначает владельца и устанавливает исходные права. Update сначала выполняет Body через CREATE OR REPLACE; только при 42P13/42723 откатывает пробу и удаляет прежние сигнатуры перед повтором. Затем убирает не затронутые Body перегрузки, назначает владельца всем оставшимся и приводит права к исходному общему набору. Всё это внутри транзакции команды. Разница только прав даёт только Grant. Delete целой процедуры по отсутствию в наборе не строится.

Ключ: Схема.Процедура

JPP.Grant
CreateUpdateDelete

Право · PostgreSQL

Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает отсутствующее право. Параметр пропуска лишних прав может сохранить лишние выдачи и возможность их передачи. Команда применяется к каждой сигнатуре этого имени. У новой процедуры может быть Delete PUBLIC:EXECUTE, снимающий умолчание PostgreSQL.

Ключ: Схема.Процедура|Получатель:Привилегия

Oracle · JPR2 кода
JPR
CreateUpdate

Процедура Oracle

Create/Update переключает CURRENT_SCHEMA и выполняет CREATE OR REPLACE с Body. Update возникает при разнице текста или Valid=false у приёмника. Права остаются отдельными Grant, замена определения сохраняет прежние выдачи. DDL фиксируется Oracle; оставшаяся невалидность выясняется при финализации схемы. Delete целой процедуры по отсутствию в наборе не строится.

Ключ: Схема.Процедура

JPR.Grant
CreateUpdateDelete

Право · Oracle

Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает отсутствующее право. Параметр пропуска лишних прав может сохранить лишние выдачи и возможность их передачи. При ORA-04063 выдача откладывается до перекомпиляции; финальный этап повторяет её и проверяет оставшиеся ошибки. Снятие GRANT OPTION требует отзыва и повторной выдачи.

Ключ: Схема.Процедура|Получатель:Привилегия

Ограничения и что с ними делать

Update PostgreSQL может удалить перегрузку

В приёмнике есть udo_p_amount(numeric) и udo_p_amount(text). В Body из набора осталось только определение числового варианта. План покажет одну Update JPP: после успешной замены она удалит строковый вариант. Строки Delete JPP для него не будет.

Перед применением смотрите полный diff Body, включая удалённые определения. Если строковый вариант нужен, сохраните его в определении из набора. Отсутствие всей JPP в выбранном наборе, напротив, не даёт команды её удаления.

Замена на месте и запасной путь DROP → CREATE

Update сначала исполняет Body без предварительного DROP. При ошибках PostgreSQL 42P13 или 42723, например при несовместимой смене имени входного аргумента, Holkas откатывает пробу к точке сохранения, удаляет все прежние сигнатуры имени и повторяет создание. Другие ошибки этот путь не включают.

Удаление выполняется без CASCADE. Если каталог PostgreSQL хранит зависимость другого объекта от этой сигнатуры, убрать перегрузку или пересоздать её может не позволить СУБД. Holkas не пересоздаёт потребителей автоматически. Заранее переведите их на оставшуюся реализацию отдельным согласованным изменением.

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

Типы перегрузок ищутся эвристически

У JPP нет переносимого поля Dependencies. Holkas эвристически ищет типы аргументов и переменных DECLARE в Body; это не полноценный SQL-парсер. Body содержит все перегрузки, и заголовок каждой читается отдельно.

Запросы и вызовы внутри Body не дают полного графа

Процедура принимает число, а внутри читает таблицу или вызывает другую процедуру. У процедуры на PL/pgSQL такие обращения сами по себе не дают ожиданий JPP: сканер ищет объявленные типы. Тело на LANGUAGE sql сканируется целиком, и таблица того же набора создаётся раньше. Подготовьте нужные опоры заранее, если их создание требуется уже для определения программы; отдельно проверьте вызов после переноса. Локальный план SQL-процедуры без ожидания таблицы сохранён в исследовании; новый отказ БД не воспроизводился.

Oracle: невалидная процедура и частичное применение

CREATE OR REPLACE может сохранить текст с ошибками компиляции. В конце переноса Holkas перекомпилирует схемы, повторяет отложенные выдачи прав и связывает оставшиеся ошибки ALL_ERRORS с исходами команд. Совпавший Body при невалидном приёмнике также даёт Update JPR.

Oracle фиксирует DDL средствами СУБД: отката всей замены, подобного PostgreSQL, нет. Например, текст уже заменён, а выдача права затем отказала — прежний текст не восстановится. Исправляйте конкретную причину и стройте новый план по фактическому состоянию; успешная запись определения не доказывает работу вызова.

Oracle: многострочные литералы переносятся точно

Вне литералов Holkas не считает различием хвостовые пробелы строк, CRLF вместо LF и пустые строки по краям: такое форматирование не создаёт Update. Текст в кавычках сохраняется точно. Если выходному аргументу присваивается строка с двумя значащими пробелами перед LF, в приёмнике они остаются на месте. Пример исходного фрагмента — между A и переводом строки два обычных пробела:

RESULT := 'A  
B';

То же относится к q'[…]', CR внутри литерала и идентификаторам в двойных кавычках.

Роли и полномочия SECURITY DEFINER

Получатели и явно заданный владелец PostgreSQL должны существовать и быть доступны учётной записи переноса. Соответствие ролей меняет имена получателей, «Замена владельцев» — только владельца; роли эти параметры не создают. Для SECURITY DEFINER владелец определяет полномочия кода: план показывает соответствующую заметку.

JPP без владельца

Файл процедуры, где поле Owner пропущено или пустое, не переносится: план не строится, а отказ называет объект. Приёмник не меняется. Выгрузите объект из базы заново или впишите нужную роль в Owner.

Лишние права и защита от каскадного отзыва

По умолчанию лишняя выдача и лишний GRANT OPTION отзываются. Параметр «Пропускать лишние права в приёмнике» сохраняет их. Если получатель уже передал право другим, Holkas защищает от скрытого каскадного отзыва; сначала согласуйте судьбу переданных прав либо снимите команду отзыва.

JPP и привязка к Парусу

Для JPP нет регистрации в справочнике конвертера Паруса: текущий обработчик регистрации подключён к функциям JFP, а не к процедурам. Это отличается от принятия самой процедурной ссылки: отчёт, пользовательская процедура, процедурный метод и пересчёт могут ждать JFP либо JPP.

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

Новый аргумент JPP и параметр отчёта в одном плане

Если JPP получает новый аргумент одновременно с параметром отчёта REP.Param, обновление процедуры встаёт раньше параметра, и план не предупреждает об отсутствии аргумента. Если процедуры в плане нет, а у неё в приёмнике нет нужного аргумента, предупреждение остаётся.

Тип аргумента и режим IN/OUT эта проверка не удостоверяет: их допустимость проверяет Парус.

SQL-файл имеет другой способ применения

Экспорт SQL сохраняет полное определение, права и явно заданного владельца PostgreSQL. Последнее определение получает завершающий разделитель; блоки DO назначают владельца и права каждой найденной сигнатуре имени с режимами IN/OUT и снимает EXECUTE у PUBLIC, если его нет в правах из набора. Oracle-файл содержит ALTER SESSION, CREATE OR REPLACE, разделитель / и выдачи прав, а в конце — пересборку схемы, как после переноса в базу.

Этот файл не строит diff с будущей базой, не удаляет исчезнувшие перегрузки и не повторяет несовместимую замену через запасной DROP → CREATE. Он также не воспроизводит точный отзыв всех лишних прав приёмника: проверьте SQL и способ исполнения своим клиентом отдельно. Настоящая выгрузка и применение SQL →

Рёбра команд

Что такое ребро и где оно видно в Holkas →

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

Учебная процедура принимает строку новой таблицы: r parus.udo_t_request. После создания пустой оболочки таблицу нужно наполнить колонками.

1 · СначалаДобавить колонку rnCreate TBP.Col
→
2 · ЗатемСоздать процедуруCreate JPP
Распознанный тип таблицы создаёт ожидания её корня и колонок из набора. Это пример типа аргумента, а не обещание разобрать все SELECT тела.

Ниже 18 правил: собственные опоры, права, непосредственные потребители процедуры и скрипты автора. Это число правил справки, а не число рёбер каждого плана.

Типы PostgreSQLПравил: 4
Create / Update TBP, JVP, CTP→Create / Update JPP

Когда: Скан Body распознал тип аргумента IN, OUT, INOUT либо переменной DECLARE в любой перегрузке.

Кандидат без схемы проверяется в схеме процедуры и parus; самоссылка исключается. Если перечень источника подтверждает объект, это настоящая зависимость; иначе ребро только упорядочивает совпавшие команды. Заголовок каждой перегрузки читается отдельно.

Create / Update TBP, JVP, JFP, JPP, SQP, CTP→Create / Update JPP

Когда: Процедура написана на LANGUAGE sql.

PostgreSQL разбирает такое тело уже при CREATE, поэтому Holkas сканирует его целиком, как текст представления: таблица из запроса и её колонки создаются раньше. Ребро только упорядочивает команды набора: без таблицы в наборе план о ней не предупреждает. Тело PL/pgSQL так не сканируется — оно проверяется при первом вызове.

Create / Update TBP.Col→Create / Update JPP

Когда: Распознан TBP, его описание есть в наборе.

Дождаться всех колонок после пустой оболочки Create TBP. Ожидания частей только для порядка: у совпавшей колонки команды может не быть.

Create / Update CTP.Item→Create / Update JPP

Когда: Распознан CTP, его описание есть в наборе.

Дождаться наполнения оболочки составного типа. Эти рёбра также только упорядочивают существующие команды.

Права после определенияПравил: 1
Create / Update JPP или JPR→Create / Update / Delete того же *.Grant

Когда: Обе команды присутствуют для одной процедуры.

Права выполняются после определения. PostgreSQL корневой командой устанавливает исходный общий набор прав, от которого считался план; более ранняя команда права была бы перезаписана.

Каталог OracleПравил: 3
Create / Update JTB, JVW, JFN, JPR, JPG, JSQ, JSY→Команда JPR или JPR.Grant, кроме Delete

Когда: В Dependencies процедуры сохранён адрес опоры.

Ожидания по Dependencies получают все команды процедуры, кроме Delete, — в том числе команды прав. Синоним и конечная цель могут дать отдельные рёбра. Наличие ссылки не создаёт команду изменения неизменившейся опоры.

Create / Update дальнейшей опоры Oracle→Команда потребителя, кроме Delete

Когда: Прямая подтверждённая ссылка ведёт к совпавшей процедуре, её описание с Dependencies доступно в наборе.

Цепочка зависимостей продолжается через объект, который сам не меняется. Например, процедура ждёт пакет, используемый совпавшей процедурой. Без описания промежуточного объекта цепочка не восстанавливается.

Create / Update JTB.Col→Команда потребителя Oracle, кроме Delete

Когда: Зависимость проходит к JTB и в плане есть реальные команды её колонок.

Уже существующая таблица может получать новые колонки: одного ожидания её корня недостаточно. Учитываются реальные команды, без требования создать совпавшие колонки.

Непосредственные потребители процедурыПравил: 9
Create / Update JPP→Create / Update JVP

Когда: У старого JVP без Dependencies скан текста встретил совпавшее имя JPP.

Это запасное эвристическое ожидание только для порядка, а не обычный вызов процедуры из VIEW: PostgreSQL-процедура вызывается CALL. Кандидат может совпасть случайно. При Dependencies=[] скан выключен; обычный каталог VIEW не описывает такой прямой вызов.

Create / Update JPR→Команда другого объекта Oracle, кроме Delete

Когда: Dependencies потребителя (JFN/JPR/JPG/JVW, триггер JTB.Trg) называет процедуру.

Та же общая обработка каталога применяется к непосредственному потребителю. Местные зависимости Oracle не выводятся из произвольного текста процедуры.

Create / Update JPP или JPR→Create / Update MET

Когда: Имя реализации метода ссылается на процедуру.

Для процедурного метода (MethodType не 1): JPR на Oracle; JFP/JPP — альтернативы на PostgreSQL. Метод пакета Oracle ждёт JPG, а PostgreSQL — имя parus.пакет$имя. Функциональный метод типа 1 требует JFN/JFP и настоящей процедурой не заменяется.

Create / Update JPP или JPR→Create / Update MET.Param

Когда: Параметр создаётся/меняется, а корень MET не получает Create.

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

Create / Update JPP или JPR→Create / Update REP

Когда: StoredProcedure отчёта называет эту реализацию.

Сначала физическая процедура, затем отчёт. На Oracle цель JPR; на PostgreSQL JPP закрывает альтернативу JFP. Отчёт и его реализация выбираются отдельно.

Create / Update JPP или JPR→Create / Update REP.Param

Когда: У параметра отчёта заполнен NameParameterProcedure.

Парус сверяет имя аргумента с реализацией; параметр ждёт её и Update REP. Наличие процедуры ещё не гарантирует допустимость перегрузок для отчёта.

Create / Update JPP или JPR→Create / Update PCE

Когда: ProcedureName пользовательской процедуры заполнен и называет эту физическую реализацию.

Подготовить физическую подпрограмму перед записью её описания в Парусе. На PostgreSQL JFP/JPP выступают альтернативами; на Oracle цель JPR; параметры PCE собственного такого ребра не добавляют.

Create / Update JPP или JPR→Create / Update MEC

Когда: Условие вызова метода содержит распознанную процедуру нужной СУБД.

Подготовить процедуру условия. Используется разбор CondType/Settings, а не поиск любого имени в XML; на Oracle цель JPR, на PostgreSQL JFP/JPP — альтернативы.

Create / Update JPP или JPR→Create / Update CLS.VF

Когда: XML формы класса содержит распознанную процедуру пересчёта; приёмник нужной СУБД.

Подготовить пересчёт до формы. На Oracle цель JPR, на PostgreSQL JFP/JPP — альтернативы. Функция описания словаря, напротив, требует JFN/JFP. Формы REP/PCE этим общим сканером не обследуются.

Скрипты автораПравил: 2
SCR Before→JPP / JPR и их Grant

Когда: БД-приёмник выполняет скрипт до этой процедуры или всего переноса.

Скрипт встаёт до команд своей области. Без команд области он в исполняемый план не попадает.

JPP / JPR и их Grant→SCR After

Когда: Та же область, время After.

Выполнить скрипт после команд процедуры и прав; это не автоматический разбор SQL-зависимостей тела.

Что этот граф не гарантирует

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

Скан JPP не строит полный граф SQL: у процедуры на PL/pgSQL запрос к таблице в теле не даёт ожидания по самому запросу. У процедуры на LANGUAGE sql тело сканируется целиком — у каждой такой перегрузки, даже если первая написана на PL/pgSQL, но таблицу, не включённую в набор, план не предлагает. Нет общего обратного порядка «все потребители перед DROP старой перегрузки»: DROP находится внутри Update JPP, и зависимость PostgreSQL может его заблокировать. Разбор недостающих зависимостей →

Как процедура хранится в файлах

Начните с ProcedurePostgres/ или ProcedureOracle/. Ниже учебные имена parus.udo_p_amount и PARUS.UDO_P_AMOUNT. Все перегрузки PostgreSQL находятся в одном Body, без файлов на каждую сигнатуру. Права и адреса зависимостей Oracle вложены в собственный файл процедуры.

Git

YAML
ProcedurePostgres/parus.udo_p_amount.yaml

Определение в Body — обычный текст. Поля Schema, Name, Grants, Owner; у Oracle — необязательный Dependencies.

При чтении YAML описание восстанавливается процедуры. Метаданные репозитория — в .holkas.

S3

JSON в ZIP
ProcedurePostgres/parus.udo_p_amount.json

Body записан строкой body, не Base64; права в grants. ZIP сохраняется в S3.

manifest.json перечисляет JPP/JPR; при загрузке читается соответствующий JSON.

Файл пакета

JSON в ZIP
ProcedurePostgres/parus.udo_p_amount.json

Скачиваемый ZIP с тем же объектным JSON процедуры и вложенным grants.

При загрузке состав берётся из manifest.json, описание восстанавливается.

Для Oracle пути соответственно ProcedureOracle/PARUS.UDO_P_AMOUNT.yaml и ProcedureOracle/PARUS.UDO_P_AMOUNT.json. В оглавлении ZIP: {"typeCode":"JPP","name":"parus.udo_p_amount"} либо {"typeCode":"JPR","name":"PARUS.UDO_P_AMOUNT"}. Манифест также содержит версию формата и СУБД — устройство пакета. Небезопасные символы имён кодируются, например / как %2F; имя объекта внутри от этого не меняется.

Запись и чтение ZIP для S3 и для файла пакета проверены отдельно, в том числе перекрёстно: для JPP/JPR устройство совпадает. Это не обобщение на все типы Holkas. Valid Oracle не сохраняется; вычисляемый Owner всегда null и опущен. Необязательные null опускаются, пустые списки сохраняются. Текущий формат не использует прежнюю Base64-упаковку программного текста.

Одни поля в YAML и JSON · PostgreSQL

Полное учебное описание одной процедуры с входным и выходным аргументом INOUT, использованное в локальной проверке записи и обратного чтения. Базы и роли для него не создаются. Язык и поведение определяются Body; > в YAML складывает строки по правилам YAML, при обратном чтении исходный текст восстанавливается. При правке многострочного кода безопаснее сохранять разметку полного экспорта.

Git — ProcedurePostgres/parus.udo_p_amount.yaml

Schema: parus
Name: udo_p_amount
Body: >
  CREATE OR REPLACE PROCEDURE parus.udo_p_amount(INOUT amount numeric)
   LANGUAGE plpgsql
  AS $procedure$BEGIN amount := amount * 1.2; END;$procedure$
Grants:
- Grantee: PUBLIC
  Privilege: EXECUTE
- Grantee: reader
  Privilege: EXECUTE
  WithGrantOption: true
Owner: parus

S3 и «Файл пакета» — ProcedurePostgres/parus.udo_p_amount.json

{
  "schema": "parus",
  "name": "udo_p_amount",
  "body": "CREATE OR REPLACE PROCEDURE parus.udo_p_amount(INOUT amount numeric)\n LANGUAGE plpgsql\nAS $procedure$BEGIN amount := amount * 1.2; END;$procedure$\n",
  "grants": [
    {
      "grantee": "PUBLIC",
      "privilege": "EXECUTE"
    },
    {
      "grantee": "reader",
      "privilege": "EXECUTE",
      "withGrantOption": true
    }
  ],
  "owner": "parus"
}
Oracle: текст и адреса зависимостей

Фрагмент объектного JSON с полным учебным определением процедуры и одной ссылкой. Для краткости опущен обязательный Grants: это не готовый файл загрузки. У настоящего экспорта он присутствует, даже когда равен [].

{
  "schema": "PARUS",
  "name": "UDO_P_AMOUNT",
  "body": "PROCEDURE UDO_P_AMOUNT(N IN NUMBER, RESULT OUT NUMBER) IS\nBEGIN\n  RESULT := UDO_UTIL.AMOUNT(N);\nEND;",
  "dependencies": [
    {
      "typeCode": "JPG",
      "name": "PARUS.UDO_UTIL"
    }
  ]
}

Учебная процедура записывает результат UDO_UTIL.AMOUNT в выходной аргумент RESULT; пакет назван в Dependencies, но его определение не вложено в JPR. В настоящем экспорте Dependencies получают из каталога исходной базы; не добавляйте произвольные адреса ради «полноты». В YAML те же поля называются Body, Dependencies, TypeCode и Name.

Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета, перенести с теста на рабочую базу.

Основа справки: текущие модель, каталоги, сравнение, граф команд, исполнители и сериализаторы Holkas 0.1.30; сохранённые результаты изучения КОР Парус 8 на редакции 27.08.2026. Сверено 9 ноября 2026. Имена и SQL на странице — учебные. Запись и чтение файлов, планы и преобразователи проверены локально; новый перенос в PostgreSQL/Oracle и новый запуск клиентов Паруса не выполнялись.