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

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

Пакет процедур Oracle

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

Oracle

В командной строке: --object JPG:PARUS.UDO_REQUEST_API · как задать состав в CLI

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

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

Oracle · программный пакет PL/SQL

Пакет объединяет подпрограммы и общие объявления доработки. Holkas переносит его спецификацию и тело под одним именем, а права меняет отдельными командами.

АдресJPG + Схема.Имя
Два текстаОдна команда JPG
Удаление пакетаНе формируется

Что это за объект

Тип объекта в Holkas: JPG — программный пакет Oracle. Например, учебный PARUS.UDO_REQUEST_API объявляет функцию TOTAL(X NUMBER) в спецификации, а формулу расчёта хранит в теле. Вызывающий код видит публичные объявления спецификации; внутренние вспомогательные элементы могут оставаться только в теле. Это устройство пакета PL/SQL.

Пакет из одних констант и типов может обходиться без тела. Если объявлены подпрограммы, которым нужна реализация, одной спецификации для их работы недостаточно. Подпрограммы внутри JPG, включая перегрузки, не выбираются и не переносятся отдельными JFN/JPR. Чтобы убрать одну из них, меняют соответствующие тексты всего пакета.

Пакет Oracle и файл пакета Holkas — разные вещи. JPG — исполняемый объект базы. ZIP-пакет Holkas — файл с выбранными объектами; в нём могут находиться несколько JPG вместе с таблицами и описаниями КОР.

В КОР Парус 8 подпрограмма пакета может служить реализацией метода класса MET. Сам MET и записи реестра CLO переносятся отдельно: запись исходного текста в реестр не исполняет его в базе. Ограничение КОР на перегруженные методы пакета относится к регистрации метода, а не к сохранению полного текста JPG.

JPG поддерживается только на Oracle. Автоматического перевода в набор функций PostgreSQL нет: для PostgreSQL нужны отдельно подготовленные определения соответствующей СУБД.

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

Использует, но не включает внутрь: таблицы, представления, другие подпрограммы, пакеты, последовательности и синонимы. Их адреса находятся в Dependencies, а определения выбираются отдельно.
Oracle хранит PACKAGE и PACKAGE BODY отдельными строками каталога. Holkas читает оба текста в один JPG и не делит его на команды спецификации и тела. Права вложены в описание, но имеют собственные команды.

У JPG нет папки каталога Паруса: ни имя папки, ни путь с родителями не читаются и не восстанавливаются. Schema — схема БД; PackageOracle/ — каталог файлов экспорта. Выбор JPG не включает обратным ходом все использующие его классы и подпрограммы.

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

13 полей · 3 группы

Все 8 свойств модели пакета, 3 поля выдачи и 2 поля адреса зависимости. Имена с заглавной буквы соответствуют Git YAML; рядом указаны имена JSON обоих ZIP. Служебные свойства учтены, даже если в файлах их нет.

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

Часть ключа задаёт адрес, «Сравнивается» означает учитываемую разницу, «По элементам» — команды отдельных выдач. «Сведения» поясняют служебное значение или данные для порядка команд без самостоятельной команды. Найденное отличие не гарантирует допустимость SQL.

Пакет · JPG8 полей
SchemaJPG · JSON: schemaстрокаЧасть ключаСхема пакета
Назначение
Пространство имён и владелец объекта Oracle: например PARUS.
При переносе:
Вместе с Name задаёт адрес JPG. Другая схема означает другой объект; схема или пользователь Oracle должны уже существовать. При применении Holkas переключает CURRENT_SCHEMA, но это не создаёт полномочий на чужую схему.
NameJPG · JSON: nameстрокаЧасть ключаИмя пакета
Назначение
Имя программного пакета внутри схемы, например UDO_REQUEST_API. Подпрограмма TOTAL внутри него не является отдельной JPG.
При переносе:
Смена имени не даёт RENAME: прежний пакет остаётся, ссылки не переписываются. При чтении БД адрес Схема.Имя приводится к верхнему регистру. Имя в Specification и Body должно соответствовать адресу; Holkas не подставляет Name внутрь заголовков.
SpecificationJPG · JSON: specificationстрокаСравниваетсяСпецификация
Назначение
Публичные объявления: процедуры, функции, типы, константы и другие элементы. Текст начинается с PACKAGE Имя, без CREATE OR REPLACE и завершающего / клиента.
При переносе:
Разница даёт Update JPG. При Create и Update Holkas дописывает CREATE OR REPLACE и записывает спецификацию перед телом. Даже при изменении одного Body спецификация записывается снова. Вне литералов CRLF и LF равны, а хвостовые пробелы строк и пустые крайние строки различием не считаются; текст литералов переносится точно. Прочие изменения текста учитываются.
BodyJPG · JSON: bodyстрока / nullСравниваетсяТело пакета
Назначение
Реализация объявленных подпрограмм и частные элементы: PACKAGE BODY Имя … END;. Пакет из одних констант или типов может не иметь тела.
При переносе:
Непустое тело записывается после спецификации той же JPG. null или пустая строка пропускают его запись и сохраняют прежнее тело в БД. Это не удаление тела: если оно есть в приёмнике, разница может оставаться и давать повторный Update. При замене null пустой строкой может появиться отметка различия, но команда JPG не формируется.
GrantsJPG · JSON: grantsсписокПо элементамПрава на пакет
Назначение
Общие выдачи на пакет целиком; отдельных прав на его тело или одну подпрограмму нет.
При переносе:
JPG.Grant сопоставляет выдачи по Grantee + Privilege, без учёта порядка. Новые добавляет, лишние отзывает, у совпавших меняет передачу права. Изменение только прав не переписывает тексты JPG. [] — пустой список явных выдач в источнике, а не отзыв неявных прав владельца.
ValidJPG · В файлы не записываетсялогическоеСравниваетсяСостояние компиляции
Назначение
Состояние приёмника из ALL_OBJECTS: false, если существующая спецификация либо тело имеет статус, отличный от VALID.
При переносе:
В описании из источника Valid считается true; источник не копирует свой INVALID как настройку. Невалидный приёмник получает Update JPG даже при одинаковом тексте. В YAML и JSON Valid не записывается; это не ручной флажок «не компилировать». Граница диагностики прежнего тела при Body=null описана отдельно ниже.
DependenciesJPG · JSON: dependenciesсписок / nullСведенияАдреса опор Oracle
Назначение
Объединение местных зависимостей спецификации и тела из ALL_DEPENDENCIES. Ссылки на себя, системные схемы, удалённые базы и неподдержанные типы исключаются.
При переносе:
Сам список не даёт Update и не создаёт опоры в БД: он нужен для порядка команд, проверки покрытия и дополнения состава. Синоним и его конечная цель сохраняются отдельно. null в старом файле и [] не запускают запасной разбор PL/SQL; динамический SQL здесь не распознаётся.
OwnerJPG · В файлы не записываетсяnullСведенияОтдельный владелец не задаётся
Назначение
Служебное общее свойство модели. В Oracle владелец пакета совпадает со Schema, поэтому Owner всегда null.
При переносе:
Нельзя назначить другого владельца отдельным полем или командой JPG. Holkas не записывает Owner ни в YAML, ни в JSON. Для другой схемы нужен согласованный адрес и текст; роли получателей переводятся отдельно от схемы.
Права · Grants[] · JPG.Grant3 поля
GranteeJPG.Grant · JSON: granteeстрокаЧасть ключаПолучатель права
Назначение
Имя существующего пользователя или роли Oracle; PUBLIC означает всех пользователей.
При переносе:
Часть ключа JPG.Grant. Смена получателя означает отзыв прежней выдачи и создание новой. Holkas не создаёт пользователя, роль или членство. При необходимости задайте соответствие ролей; обычные имена Oracle используются в верхнем регистре.
PrivilegeJPG.Grant · JSON: privilegeстрокаЧасть ключаПривилегия
Назначение
Обычно EXECUTE — разрешение пользоваться публичными подпрограммами пакета. Каталог читает привилегии, выданные объекту, без ограничения одним EXECUTE.
При переносе:
Вторая часть ключа JPG.Grant, хранится заглавными буквами. GRANT относится ко всему пакету, например PARUS.UDO_REQUEST_API, а не к UDO_REQUEST_API.TOTAL. Допустимость привилегии и полномочия выдающего проверяет Oracle.
WithGrantOptionJPG.Grant · JSON: withGrantOptionлогическое / nullСравниваетсяПередача права
Назначение
true разрешает получателю выдавать эту привилегию другим. false нормализуется в null — обычное право без передачи.
При переносе:
Update JPG.Grant добавляет передачу повторной выдачей. Чтобы снять передачу, Oracle-путь отзывает право и выдаёт его снова без WITH GRANT OPTION. Если получатель уже передал право дальше, Holkas отказывает до каскадного отзыва; подробнее в ограничениях.
Адреса опор · Dependencies[]2 поля
TypeCodeDependencies · JSON: typeCodeстрокаСведенияТип опоры
Назначение
Код объекта, названного каталогом: JTB, JVW, JFN, JPR, JPG, JSQ или JSY.
При переносе:
Вместе с Name адресует опору для порядка и проверки наличия. Это не новая команда JPG.Dep и не запись реестра CLO.Dep. PACKAGE и PACKAGE BODY одной цели представлены одним JPG.
NameDependencies · JSON: nameстрокаСведенияАдрес опоры
Назначение
Схема и имя объекта Oracle, например PARUS.UDO_T_REQUEST.
При переносе:
Сохраняйте адрес из экспорта: он связывает пакет с определением опоры. Ручное добавление записи не переписывает SQL и не делает удалённую базу местной. Сам объект опоры хранится отдельным файлом, если выбран в выгрузку.
Grants=[], пропуск поля и сохранение лишних прав

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

По умолчанию лишние выдачи выбранного существующего пакета отзываются. Параметр «Пропускать лишние права в приёмнике» сохраняет и выдачи сверх источника, и лишнюю возможность передачи. Недостающие права выдаются в любом случае. Неявные полномочия владельца в Grants не записываются.

Текст определения и заголовки

В Specification нужен PACKAGE Имя, в Body — PACKAGE BODY Имя. CREATE OR REPLACE добавляет Holkas при записи, а / нужен клиенту SQL при чтении скрипта и в поля не входит. Не вставляйте в поле весь SQL-файл с ALTER SESSION и GRANT.

Schema выбирает текущую схему сессии; Name не переписывает имя внутри текста. Например, если адрес UDO_REQUEST_API, а заголовок называет OTHER_API, SQL будет создавать OTHER_API, тогда как права и проверки адресуются UDO_REQUEST_API. Согласуйте адрес, оба заголовка и END.

В Git корневая команда сохраняет заданный Body, включая null: поле исчезает из YAML. Это отличается от пропуска записи тела в БД.

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

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

Два кода команд, пять поддерживаемых действий. Подпись пиктограммы доступна мышью, клавиатурой и нажатием. Описание SQL ниже относится к приёмнику БД; в Git команды изменяют сохраняемое описание, а S3 и «Файл пакета» пишут новый ZIP.

JPG
CreateUpdate

Спецификация и тело одной командой

Create создаёт пакет, которого нет в приёмнике. Update заменяет спецификацию и непустое тело при изменении любого из них либо при INVALID. Порядок внутри команды: CURRENT_SCHEMA → CREATE OR REPLACE спецификации → CREATE OR REPLACE тела, если оно задано. Изменение только прав или Dependencies не требует JPG. Удаление подпрограммы из обоих текстов меняет весь пакет, без отдельного Delete подпрограммы.

Ключ: Схема.Имя пакета

JPG.Grant
CreateUpdateDelete

Одна выдача на весь пакет

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

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

Delete JPG, JPG.Body, JPG.Specification и SetOrder не формируются. Изменение только тела всё равно заменяет оба текста. При отказе второй стадии спецификация уже могла сохраниться.

Пример: изменить формулу и снять передачу EXECUTE

В приёмнике TOTAL возвращает X + 1, а READER имеет EXECUTE с передачей. В источнике формула стала X + 2 и передача снята; спецификация и само право EXECUTE сохранены.

  1. Update JPG · PARUS.UDO_REQUEST_API повторно записывает прежнюю спецификацию, затем новое тело.
  2. Update JPG.Grant · PARUS.UDO_REQUEST_API|READER:EXECUTE ждёт JPG, отзывает прежнюю выдачу и выдаёт EXECUTE без передачи.

Если READER уже передал право другому пользователю, вторая команда откажет до каскадного отзыва. Изменившаяся формула от этого не откатится. При включённом сохранении лишних прав вторая команда не появляется.

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

В источнике нет тела, а в приёмнике оно есть

Body=null или пустая строка не вызывает DROP PACKAGE BODY. Например, источник задаёт только константу C_ANSWER, а в приёмнике осталось старое тело с TOTAL. Holkas меняет спецификацию, прежнее тело остаётся и может стать несовместимым. Тогда команда JPG завершается отказом с ошибкой компиляции этого тела, а не успехом.

Такой перенос не приводит пакет к точному отсутствию тела: следующее сравнение по-прежнему видит лишний текст и может снова предложить Update JPG. Если нужна работающая реализация, включите согласованное тело; если требуется удалить прежнее, подготовьте это как отдельное осознанное действие в Oracle. Не используйте пустой Body как команду удаления.

Пакет остался INVALID

Oracle может принять определение с ошибками компиляции. Holkas в конце пересобирает невалидные объекты затронутых схем и проверяет выбранные определения. Для переданного тела оставшаяся ошибка возвращается в исход JPG с текстом, строкой и позицией Oracle. Невалидность приёмника даёт Update даже при совпавших текстах; повтор той же ошибочной программы не исправляет её.

Прежнее тело, которое источник не передал, проверяется так же: если при Body=null или пустой строке оно не компилируется с новой спецификацией, исход JPG получает отказ с текстом, строкой и позицией ошибки PACKAGE BODY. Чужие невалидные объекты вне выбранного набора исход не меняют.

Две DDL-стадии не откатываются вместе

Если новая спецификация записана, а тело не удалось заменить, уже выполненный DDL остаётся в Oracle. Одна команда JPG не означает одной откатываемой транзакции. Режим переноса одной транзакцией для Oracle не поддерживается.

Например, после добавления обязательной процедуры в спецификацию старое тело без её реализации не обеспечивает новый интерфейс. Исправьте согласованную пару текстов и причину отказа, затем повторите перенос. Успех записи текста не доказывает работоспособность всех вызовов.

Право передано дальше

Пользователь A получил EXECUTE WITH GRANT OPTION и выдал его B. Отзыв у A в Oracle затронул бы B. Holkas сначала проверяет такие выдачи и отказывает в каскадном отзыве; тот же запрет действует при снятии передачи, поскольку этот путь использует REVOKE и повторный GRANT.

Согласуйте отзыв у B отдельно либо снимите команду отзыва у A. Новый получатель должен уже существовать; список Grants не создаёт учётные записи. Изменение привилегий не заменяет проверку необходимых прямых прав для компиляции чужих объектов.

Значащие пробелы перед переводом строки

Вне литералов Holkas не считает различием хвостовые пробелы строк, CRLF вместо LF и пустые строки по краям: такое форматирование не создаёт Update. Текст в кавычках сохраняется точно — и в спецификации, и в теле: если литерал содержит A, два пробела и перевод строки, оба пробела доезжают до приёмника. То же относится к q'[…]', CR внутри литерала и идентификаторам в двойных кавычках.

Состояние пакета в работающих сеансах

Перенос сохраняет определение, а не значения переменных уже работающего пакета. При перекомпиляции используемого пакета с состоянием Oracle может сбросить его и вернуть ORA-04068 при следующем вызове. Это правило Oracle о состоянии пакета, не ошибка сравнения JPG. Планируйте замену вместе с обработкой повторного подключения или повторного вызова в приложении.

Рёбра команд

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

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

В спецификации учебного пакета аргумент имеет тип UDO_T_REQUEST.ID%TYPE. В приёмнике таблица уже есть, но колонки ID ещё нет.

1 · СначалаДобавить колонку IDCreate JTB.Col
→
2 · ЗатемСоздать пакетCreate JPG
Каталог источника сохраняет зависимость пакета на таблицу; общий порядок также учитывает реальные команды её колонок. Это не разбор строки %TYPE из произвольного файла.

Каталог правил

9 правил: собственные права, каталог Oracle, непосредственные потребители и скрипты. Это число правил справки, а не число рёбер каждого плана.

Права после определения1 правило
Create / Update JPG→Create / Update / Delete JPG.Grant

Когда: Обе команды относятся к одному пакету.

Сначала записать определение, затем изменить выдачу. Если пакет уже совпал, повторная JPG для выдачи не нужна.

Сохранённые зависимости Oracle3 правила
Create / Update JTB, JVW, JFN, JPR, JPG, JSQ, JSY→Команда JPG или JPG.Grant, кроме Delete

Когда: В Dependencies пакета сохранён адрес опоры, прочитанный из каталога Oracle.

Учитываются зависимости обеих половин пакета. Права тоже получают эти ожидания; Delete JPG.Grant их не наследует. Синоним и конечная цель могут дать два ожидания. Самоссылка не добавляется.

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

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

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

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

Когда: При разборе цепочки зависимостей найдена JTB и в плане есть реальные команды её колонок.

Пакет с аргументом UDO_T_REQUEST.ID%TYPE должен дождаться новой ID даже в уже существующей таблице. Ожидание одного корня таблицы не заменяет этого правила.

Кто использует пакет3 правила
Create / Update JPG→Команда другого объекта Oracle, кроме Delete

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

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

Create / Update JPG→Create / Update MET

Когда: Name метода непустое, Package задаёт имя пакета PARUS; приёмник Oracle.

Метод класса ждёт пакет целиком, даже если использует только TOTAL. Это не создание отдельной JFN/JPR для подпрограммы. Для файлового приёмника тип определяется по источнику и набору.

Create / Update JPG→Create / Update MET.Param

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

Параметр сам ждёт реализацию. При Create MET он получает порядок через родителя. На Delete MET.Param такое ожидание не добавляется.

Скрипты до и после2 правила
SCR Before→JPG / JPG.Grant

Когда: Приёмник исполняет скрипты; скрипт относится к этому JPG либо всему переносу.

Выполнить скрипт до команд пакета. Когда у охваченных объектов нет команд, скрипт убирается из плана.

JPG / JPG.Grant→SCR After

Когда: Та же область скрипта, When=After.

Выполнить скрипт после команд пакета и его прав.

Границы графа, выбор и циклы

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

Рёбра строятся по Dependencies обеих половин. Прежний файл без списка не получает запасного сканирования PL/SQL. Вызов EXECUTE IMMEDIATE и обращения через DB link могут требовать объектов и прав, которых этот каталог не перечисляет.

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

Ролям и папкам не соответствуют команды создания JPG.Grant. Порядок двух текстов внутри JPG задаётся самой командой при применении, а не рёбрами плана.

Как пакет Oracle хранится в файлах

Начните с каталога PackageOracle/. Одна JPG содержит два обычных текста, Grants и, если сохранён, Dependencies. Ни отдельного файла тела, ни файла на каждую подпрограмму или выдачу нет.

Git

YAML
PackageOracle/PARUS.UDO_REQUEST_API.yaml

Specification, Body, Grants и Dependencies в одном YAML, имена с заглавной буквы. Valid и Owner не записываются.

При чтении восстанавливается описание пакета вместе с правами и зависимостями. В корне репозитория — .holkas со сведениями о нём.

S3

JSON в ZIP
PackageOracle/PARUS.UDO_REQUEST_API.json

Те же тексты и вложенные списки в одном JSON с именами specification, body, grants, dependencies. Состав перечислен в manifest.json.

Holkas кладёт ZIP в S3 и берёт описание JPG по адресу из оглавления.

Файл пакета

JSON в ZIP
PackageOracle/PARUS.UDO_REQUEST_API.json

Скачиваемый ZIP содержит такой же JSON одного JPG. Повторных строк для спецификации или тела в оглавлении нет.

Holkas сверяет загруженный файл с manifest.json и восстанавливает пакет вместе с правами.

Для JPG S3 и «Файл пакета» записывают и читают ZIP по одной раскладке; локально проверено и перекрёстное чтение. Это утверждение о JPG, а не обо всех типах. В манифесте: {"typeCode":"JPG","name":"PARUS.UDO_REQUEST_API"}. Метаданные ZIP, включая СУБД oracle, описаны в формате пакета. Небезопасные символы адреса кодируются в имени файла; например / становится %2F. Не переименовывайте файл отдельно от адреса.

Один учебный пакет в YAML и JSON

Полные учебные описания одного JPG, записанные самим Holkas и прочитанные обратно. В примере нет внешних опор, поэтому Dependencies=[]; это настоящий пустой список, а не обозначение опущенных ссылок. Пользователь READER и схема PARUS должны существовать. Примеры проверены чтением файлов в Holkas, новый перенос в БД не выполнялся.

Git — PackageOracle/PARUS.UDO_REQUEST_API.yaml

Schema: PARUS
Name: UDO_REQUEST_API
Specification: >-
  PACKAGE UDO_REQUEST_API AS
    FUNCTION TOTAL(X NUMBER) RETURN NUMBER;
  END UDO_REQUEST_API;
Body: >-
  PACKAGE BODY UDO_REQUEST_API AS
    FUNCTION TOTAL(X NUMBER) RETURN NUMBER IS
    BEGIN RETURN X + 1; END;
  END UDO_REQUEST_API;
Grants:
- Grantee: READER
  Privilege: EXECUTE
  WithGrantOption: true
Dependencies: []

S3 и «Файл пакета» — PackageOracle/PARUS.UDO_REQUEST_API.json

{
  "schema": "PARUS",
  "name": "UDO_REQUEST_API",
  "specification": "PACKAGE UDO_REQUEST_API AS\n  FUNCTION TOTAL(X NUMBER) RETURN NUMBER;\nEND UDO_REQUEST_API;",
  "body": "PACKAGE BODY UDO_REQUEST_API AS\n  FUNCTION TOTAL(X NUMBER) RETURN NUMBER IS\n  BEGIN RETURN X + 1; END;\nEND UDO_REQUEST_API;",
  "grants": [
    {
      "grantee": "READER",
      "privilege": "EXECUTE",
      "withGrantOption": true
    }
  ],
  "dependencies": []
}

YAML хранит многострочные тексты без Base64. В JSON перевод строки записывается как \n, а некоторые символы Holkas может экранировать кодом Unicode: после чтения получается тот же текст. Body=null и Dependencies=null опускаются; пустая строка Body и пустые списки сохраняются. Valid и вычисляемый Owner отсутствуют в обоих форматах.

SQL-файл повторяет команды применения в БД: ALTER SESSION, CREATE OR REPLACE спецификации и тела, затем GRANT командами JPG.Grant; каждый блок PL/SQL завершается /, а файл заканчивается пересборкой схемы (DBMS_UTILITY.COMPILE_SCHEMA), как перенос в базу. Это сценарий определения и выдач, без сравнения с существующим приёмником и без автоматического отзыва лишних прав. См. как выгрузить SQL.

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

Основа справки: устройство пакетов по документации Oracle; руководство КОР Парус 8, издание 2026, с. 76 о методах и с. 116–117 о реестре объектов; текущие DTO, каталог, построители, исполнители и файловые транспорты Holkas 0.1.30. Сверено 9 ноября 2026. Имена UDO_REQUEST_API и READER — учебные. Нового переноса в Oracle и проверки клиента Паруса при подготовке страницы не было.