Oracle · программный пакет PL/SQL
Пакет объединяет подпрограммы и общие объявления доработки. Holkas переносит его спецификацию и тело под одним именем, а права меняет отдельными командами.
JPG + Схема.ИмяЧто это за объект
Тип объекта в Holkas: JPG — программный пакет Oracle. Например, учебный PARUS.UDO_REQUEST_API объявляет функцию TOTAL(X NUMBER) в спецификации, а формулу расчёта хранит в теле. Вызывающий код видит публичные объявления спецификации; внутренние вспомогательные элементы могут оставаться только в теле. Это устройство пакета PL/SQL.
Пакет из одних констант и типов может обходиться без тела. Если объявлены подпрограммы, которым нужна реализация, одной спецификации для их работы недостаточно. Подпрограммы внутри JPG, включая перегрузки, не выбираются и не переносятся отдельными JFN/JPR. Чтобы убрать одну из них, меняют соответствующие тексты всего пакета.
В КОР Парус 8 подпрограмма пакета может служить реализацией метода класса MET. Сам MET и записи реестра CLO переносятся отдельно: запись исходного текста в реестр не исполняет его в базе. Ограничение КОР на перегруженные методы пакета относится к регистрации метода, а не к сохранению полного текста JPG.
JPG поддерживается только на Oracle. Автоматического перевода в набор функций PostgreSQL нет: для PostgreSQL нужны отдельно подготовленные определения соответствующей СУБД.
Что входит в перенос
У JPG нет папки каталога Паруса: ни имя папки, ни путь с родителями не читаются и не восстанавливаются. Schema — схема БД; PackageOracle/ — каталог файлов экспорта. Выбор JPG не включает обратным ходом все использующие его классы и подпрограммы.
Справочник полей
13 полей · 3 группыВсе 8 свойств модели пакета, 3 поля выдачи и 2 поля адреса зависимости. Имена с заглавной буквы соответствуют Git YAML; рядом указаны имена JSON обоих ZIP. Служебные свойства учтены, даже если в файлах их нет.
Как читать обозначения
Подсказки значков открываются мышью, клавишей Tab и нажатием.
Часть ключа задаёт адрес, «Сравнивается» означает учитываемую разницу, «По элементам» — команды отдельных выдач. «Сведения» поясняют служебное значение или данные для порядка команд без самостоятельной команды. Найденное отличие не гарантирует допустимость 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 и не делает удалённую базу местной. Сам объект опоры хранится отдельным файлом, если выбран в выгрузку.
Команды плана
Два кода команд, пять поддерживаемых действий. Подпись пиктограммы доступна мышью, клавиатурой и нажатием. Описание SQL ниже относится к приёмнику БД; в Git команды изменяют сохраняемое описание, а S3 и «Файл пакета» пишут новый ZIP.
JPGСпецификация и тело одной командой
Create создаёт пакет, которого нет в приёмнике. Update заменяет спецификацию и непустое тело при изменении любого из них либо при INVALID. Порядок внутри команды: CURRENT_SCHEMA → CREATE OR REPLACE спецификации → CREATE OR REPLACE тела, если оно задано. Изменение только прав или Dependencies не требует JPG. Удаление подпрограммы из обоих текстов меняет весь пакет, без отдельного Delete подпрограммы.
Ключ: Схема.Имя пакета
JPG.GrantОдна выдача на весь пакет
Create выдаёт привилегию, Delete отзывает её у получателя. Update меняет возможность передачи; снятие передачи использует REVOKE и повторный GRANT. Корневая JPG сохраняет существующие выдачи; её замена не выдаёт права сама. При ORA-04063 выдача откладывается до пересборки схемы и сверяется затем с состоянием исполненных команд.
Ключ: Схема.Имя пакета|Получатель:Привилегия
Delete JPG, JPG.Body, JPG.Specification и SetOrder не формируются. Изменение только тела всё равно заменяет оба текста. При отказе второй стадии спецификация уже могла сохраниться.
Пример: изменить формулу и снять передачу EXECUTE
В приёмнике TOTAL возвращает X + 1, а READER имеет EXECUTE с передачей. В источнике формула стала X + 2 и передача снята; спецификация и само право EXECUTE сохранены.
Update JPG · PARUS.UDO_REQUEST_APIповторно записывает прежнюю спецификацию, затем новое тело.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 ещё нет.
Create JTB.ColCreate JPGКаталог правил
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
YAMLPackageOracle/PARUS.UDO_REQUEST_API.yamlSpecification, Body, Grants и Dependencies в одном YAML, имена с заглавной буквы. Valid и Owner не записываются.
При чтении восстанавливается описание пакета вместе с правами и зависимостями. В корне репозитория — .holkas со сведениями о нём.S3
JSON в ZIPPackageOracle/PARUS.UDO_REQUEST_API.jsonТе же тексты и вложенные списки в одном JSON с именами specification, body, grants, dependencies. Состав перечислен в manifest.json.
Holkas кладёт ZIP в S3 и берёт описание JPG по адресу из оглавления.Файл пакета
JSON в ZIPPackageOracle/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 и проверки клиента Паруса при подготовке страницы не было.