Программный код базы · PostgreSQL и Oracle
Процедура хранит исполняемую программу под именем в базе. Например, доработка КОР Парус 8 вызывает процедуру для расчёта суммы: перенос меняет её определение, а новые суммы вычисляются при последующих вызовах.
JPP / JPR + Схема.ИмяПроцедура и её перегрузки
Тип объекта в Holkas: JPP — процедура PostgreSQL, JPR — процедура Oracle. Holkas переносит определение с входными и выходными аргументами, настройки и права. PL/SQL автоматически не переводится в PL/pgSQL: для другой СУБД нужна отдельная реализация.
В PostgreSQL несколько процедур могут иметь одно имя, но разные входные аргументы. Такие варианты называют перегрузками. Например, учебная parus.udo_p_amount(numeric) принимает число, а parus.udo_p_amount(text) — строку. Имя с типами входных аргументов называют сигнатурой. Это разные способы вызвать процедуру, а не история её версий.
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 не выполняет.
Что входит в перенос
У процедуры нет папки каталога Паруса: ни имя узла, ни полный путь с родителями не переносятся и не создаются. Schema — пространство имён СУБД. Каталоги ProcedurePostgres/ProcedureOracle в Git и ZIP — раскладка файлов экспорта.
Справочник полей
17 полей · 4 группы5 свойств PostgreSQL, 7 Oracle, 3 поля права и 2 поля адреса зависимости. Имена с большой буквы соответствуют YAML; в JSON первая буква маленькая. Служебные Valid и Owner Oracle учтены отдельно.
Как читать обозначения
Подсказка значка открывается мышью, клавишей Tab или нажатием.
Ключ задаёт сопоставление, «Сравнивается» — обнаруживаемую разницу, «По элементам» — отдельные команды прав. 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 и обращения через удалённую базу не становятся локальными зависимостями простой правкой этого списка.
Команды плана
Четыре кода: определение и права каждой СУБД. У целой процедуры только Create/Update, у права также Delete. Перегрузки, аргументы и позиции отдельных команд не имеют.
PostgreSQL · JPP2 кода
JPPПроцедура PostgreSQL
Create исполняет Body, назначает владельца и устанавливает исходные права. Update сначала выполняет Body через CREATE OR REPLACE; только при 42P13/42723 откатывает пробу и удаляет прежние сигнатуры перед повтором. Затем убирает не затронутые Body перегрузки, назначает владельца всем оставшимся и приводит права к исходному общему набору. Всё это внутри транзакции команды. Разница только прав даёт только Grant. Delete целой процедуры по отсутствию в наборе не строится.
Ключ: Схема.Процедура
JPP.GrantПраво · PostgreSQL
Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает отсутствующее право. Параметр пропуска лишних прав может сохранить лишние выдачи и возможность их передачи. Команда применяется к каждой сигнатуре этого имени. У новой процедуры может быть Delete PUBLIC:EXECUTE, снимающий умолчание PostgreSQL.
Ключ: Схема.Процедура|Получатель:Привилегия
Oracle · JPR2 кода
JPRПроцедура Oracle
Create/Update переключает CURRENT_SCHEMA и выполняет CREATE OR REPLACE с Body. Update возникает при разнице текста или Valid=false у приёмника. Права остаются отдельными Grant, замена определения сохраняет прежние выдачи. DDL фиксируется Oracle; оставшаяся невалидность выясняется при финализации схемы. Delete целой процедуры по отсутствию в наборе не строится.
Ключ: Схема.Процедура
JPR.GrantПраво · 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. После создания пустой оболочки таблицу нужно наполнить колонками.
Create TBP.ColCreate JPPНиже 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
YAMLProcedurePostgres/parus.udo_p_amount.yamlОпределение в Body — обычный текст. Поля Schema, Name, Grants, Owner; у Oracle — необязательный Dependencies.
При чтении YAML описание восстанавливается процедуры. Метаданные репозитория — в .holkas.S3
JSON в ZIPProcedurePostgres/parus.udo_p_amount.jsonBody записан строкой body, не Base64; права в grants. ZIP сохраняется в S3.
manifest.json перечисляет JPP/JPR; при загрузке читается соответствующий JSON.Файл пакета
JSON в ZIPProcedurePostgres/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 и новый запуск клиентов Паруса не выполнялись.