Структура базы · PostgreSQL и Oracle
Представление сохраняет запрос под именем в базе. Например, список заявок читает номер и статус из таблицы через udo_v_request; изменение запроса меняет состав и вычисление этого списка.
JVP / JVW + Схема.Имя
SQL-представление и представление класса
Представление базы — именованный SQL-запрос. Holkas переносит определение обычного VIEW: какие колонки он выдаёт и откуда их получает. Строки результата не сохраняются в пакете: при запросе их вычисляет база приёмника по своим данным. Материализованное представление с сохранённым результатом в эти два типа не входит.
В Holkas JVP — представление PostgreSQL, JVW — Oracle. JVW · PARUS.UDO_V_REQUEST автоматически не переводится в JVP · parus.udo_v_request: каждому приёмнику нужен SQL его платформы.
Представление класса VIW описывает поля и доступ в КОР Парус 8; оно может использовать физический VIEW либо собственный запрос. Это отдельный объект. Запись реестра CLO хранит исходный текст, но её перенос не выполняет этот DDL. Выбор JVP/JVW сам по себе не создаёт VIW, класс или пункт меню. В клиентском VIEW Паруса запрос также должен соблюдать правила чтения раздела и проверки доступа; выдача SELECT сама не добавляет проверку доступа к каждой записи.
Что входит в перенос
У представления нет переносимой папки Паруса: ни имя каталога, ни цепочка его родителей не читаются и не создаются. Schema — пространство имён СУБД; каталог ViewPostgres/ViewOracle в файлах — раскладка экспорта, не дерево папок КОР.
Справочник полей
20 полей · 4 группы7 свойств PostgreSQL, 8 Oracle, 3 поля права и 2 поля адреса зависимости. Имена с большой буквы соответствуют Git YAML, JSON начинается с маленькой. Служебные Valid и Owner Oracle учтены отдельно.
Как читать обозначения
Подсказка значка открывается мышью, клавишей Tab или нажатием.
Ключ определяет сопоставление, «Сравнивается» — обнаруживаемую разницу, «По элементам» — отдельные команды прав. Dependencies служит порядку и проверке ссылок; его изменение само по себе не вызывает DDL. Обнаруженная разница не гарантирует, что СУБД разрешит команду.
Представление PostgreSQL · JVP7 полей
SchemaJVP · JSON: schemaстрокаЧасть ключаСхема- Назначение
- Пространство имён представления: например parus в PostgreSQL или PARUS в Oracle.
- При переносе:
- Вместе с Name задаёт адрес. Новая схема — другое сопоставление, а не перемещение прежнего представления. Схему или пользователя Oracle эта команда не создаёт.
NameJVP · JSON: nameстрокаЧасть ключаИмя представления- Назначение
- Имя без схемы, например udo_v_request.
- При переносе:
- Смена имени описывает другой объект: при его отсутствии будет Create. Старое представление автоматически не переименовывается и не удаляется. Ссылки в других SQL-текстах сами не меняются.
DefinitionJVP · JSON: definitionстрокаСравниваетсяЗапрос представления- Назначение
- Текст SELECT после AS, как его печатает pg_views.definition. Заголовок CREATE VIEW в поле не входит.
- При переносе:
- Create/Update исполняет CREATE OR REPLACE VIEW с этим текстом; при несовместимых прежних колонках Update переходит к пересозданию. Завершающую «;», с которой СУБД печатает запрос, команда не повторяет: в SQL плана и SQL-файла она одна, а поле хранится как прочитано. CRLF и LF равны. При разном написании Holkas пробует напечатать запрос из набора средствами приёмника; совпадение этой записи с текущей убирает ложную разницу. Если проба не удалась, остаётся текстовое сравнение.
GrantsJVP · JSON: grantsсписокПо элементамПрава на представление- Назначение
- Явные привилегии получателей на весь объект. Это не членство в ролях и не отдельные права на колонки.
- При переносе:
- Сопоставляются по Grantee:Privilege; порядок записей несущественен. Create выдаёт право, Delete отзывает, Update меняет GRANT OPTION. [] может отозвать все переносимые права; параметр пропуска лишних прав сохраняет их и лишний GRANT OPTION.
OwnerJVP · JSON: ownerстрокаСравниваетсяРоль-владелец- Назначение
- Владелец PostgreSQL может отличаться от имени схемы. Настройки соответствия ролей и замены владельцев меняют имя из набора до сравнения.
- При переносе:
- Явное имя задаётся ALTER VIEW OWNER TO; роль должна существовать, а учётная запись переноса — иметь право её назначить. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется.
OptionsJVP · JSON: optionsсписок / nullСравниваетсяПараметры представления- Назначение
- Параметры PostgreSQL из pg_class.reloptions в виде «имя=значение», по порядку имён: security_barrier, check_option (так СУБД хранит WITH LOCAL или CASCADED CHECK OPTION), security_invoker. В тексте Definition их нет.
- При переносе:
- Каждое создание и обновление передаёт полный список в WITH (...): CREATE OR REPLACE VIEW без него снимает параметры даже при замене на месте. Смена одних параметров даёт Update. [] снимает параметры приёмника. Null — файл, записанный версией Holkas без этого поля: параметры не сравниваются, при обновлении сохраняются параметры приёмника, новое VIEW создаётся без них. Параметр, которого не знает версия приёмника (security_invoker до PostgreSQL 15), применение отвергает, и команда откатывается.
DependenciesJVP · JSON: dependenciesсписок / nullДля порядкаИспользуемые объекты- Назначение
- Адреса объектов, от которых зависит запрос; у каждого TypeCode и Name. Это ссылки, а не вложенные определения таблиц или функций.
- При переносе:
- Каталог pg_depend даёт настоящие зависимости на TBP, JVP, JFP, JPP, SQP и CTP. Null включает запасной скан Definition; [] означает отсутствие сохранённых ссылок и выключает скан. Скан только упорядочивает совпавшие команды. Новые файлы лучше получать полным экспортом, сохраняя Dependencies.
Представление Oracle · JVW8 полей
SchemaJVW · JSON: schemaстрокаЧасть ключаСхема- Назначение
- Пространство имён представления: например parus в PostgreSQL или PARUS в Oracle.
- При переносе:
- Вместе с Name задаёт адрес. Новая схема — другое сопоставление, а не перемещение прежнего представления. Схему или пользователя Oracle эта команда не создаёт.
NameJVW · JSON: nameстрокаЧасть ключаИмя представления- Назначение
- Имя без схемы, например udo_v_request.
- При переносе:
- Смена имени описывает другой объект: при его отсутствии будет Create. Старое представление автоматически не переименовывается и не удаляется. Ссылки в других SQL-текстах сами не меняются.
ColumnsJVW · JSON: columnsсписок строкСравниваетсяИмена выходных колонок- Назначение
- Имена заголовка VIEW в порядке COLUMN_ID. Например NRN, SSTATUS соответствуют выражениям T.RN, T.STATUS. Это свойства определения, а не отдельно изменяемые колонки таблицы.
- При переносе:
- Порядок значим: перестановка имён даёт Update JVW и меняет соответствие выражениям SELECT. Create/Update пишет список в скобках перед AS; при [] список в заголовке опускается и имена определяет запрос. Команд JVW.Col и SetOrder нет.
DefinitionJVW · JSON: definitionстрокаСравниваетсяЗапрос представления- Назначение
- Текст после AS из ALL_VIEWS.TEXT, прочитанный целиком, включая длинные определения. Имена выходных колонок задаёт Columns.
- При переносе:
- Create/Update выполняет CREATE OR REPLACE FORCE VIEW с этим запросом. Вне литералов CRLF и LF равны, а хвостовые пробелы строк и пустые крайние строки различием не считаются. Текст литералов и идентификаторов в кавычках переносится точно, включая пробелы перед переводом строки. FORCE допускает невалидное определение: успешное DDL не доказывает выполнение запроса.
GrantsJVW · JSON: grantsсписокПо элементамПрава на представление- Назначение
- Явные привилегии получателей на весь объект. Это не членство в ролях и не отдельные права на колонки.
- При переносе:
- Сопоставляются по Grantee:Privilege; порядок записей несущественен. Create выдаёт право, Delete отзывает, Update меняет GRANT OPTION. [] может отозвать все переносимые права; параметр пропуска лишних прав сохраняет их и лишний GRANT OPTION.
ValidJVW · JSON: не сохраняетсялогическоеСравниваетсяСкомпилирован ли объект приёмника- Назначение
- Состояние ALL_OBJECTS.STATUS, которое снимается при чтении приёмника. Описание из набора имеет true, даже если исходный объект сейчас невалиден.
- При переносе:
- Valid=false у приёмника даёт Update JVW при совпавшем тексте. Поле не записывается ни в YAML, ни в JSON; это не команда сделать определение рабочим вопреки отсутствующим таблицам. Изменение только используемой функции не заставляет заново писать совпавший валидный VIEW.
DependenciesJVW · JSON: dependenciesсписок / nullДля порядкаИспользуемые объекты- Назначение
- Адреса объектов, от которых зависит запрос; у каждого TypeCode и Name. Это ссылки, а не вложенные определения таблиц или функций.
- При переносе:
- Читается из ALL_DEPENDENCIES: JTB, JVW, JFN, JPR, JPG, JSQ, JSY; локальный синоним разворачивается также до цели. Системные, удалённые и неподдерживаемые объекты исключены. Null и [] не включают скан SQL. Список сам по себе Update не создаёт; если описание совпавшего объекта есть в наборе, порядок команд учитывает и его зависимости.
OwnerJVW · JSON: не сохраняетсявсегда nullСлужебноеОтдельного владельца нет- Назначение
- В Oracle владелец и схема — одно имя, которое уже находится в Schema. Owner — вычисляемое служебное свойство общей модели прав.
- При переносе:
- Не задаётся и не сохраняется: null при записи опускается. Владельца нельзя переключить отдельным ALTER OWNER. Для другой схемы нужен объект с другим адресом и необходимые права Oracle.
Право на объект · JVP.Grant / JVW.Grant3 поля
GranteeJVP.Grant / JVW.Grant · JSON: granteeстрокаЧасть ключаПолучатель права- Назначение
- Имя роли или пользователя, либо PUBLIC. При чтении PostgreSQL Holkas исключает неявные собственные права владельца; Oracle читает явные ALL_TAB_PRIVS.
- При переносе:
- Вместе с Privilege задаёт ключ права. Смена получателя даёт отзыв прежнему и выдачу новому. PUBLIC и привилегия приводятся к верхнему регистру; имена ролей — к обычному регистру СУБД (PostgreSQL — нижний, Oracle — верхний). Получатель должен существовать; Holkas его не создаёт.
PrivilegeJVP.Grant / JVW.Grant · JSON: privilegeстрокаЧасть ключаПривилегия- Назначение
- Например SELECT позволяет читать представление. Доступ на изменение зависит также от устройства запроса и правил СУБД.
- При переносе:
- Код приводится к верхнему регистру. Смена SELECT на UPDATE даёт Delete прежнего права и Create нового. Grant не делает произвольный запрос обновляемым. Кто первоначально выдал право, в модели не сохраняется.
WithGrantOptionJVP.Grant / JVW.Grant · JSON: withGrantOptiontrue / nullСравниваетсяРазрешено передать право дальше- Назначение
- true разрешает получателю выдавать эту привилегию другим; null — обычное право. Входное false нормализуется в null.
- При переносе:
- Изменение при прежнем ключе даёт Update права. PostgreSQL снимает GRANT OPTION отдельно; Oracle ради снятия отзывает и выдаёт обычное право. Если отзыв затронет тех, кому получатель передал право, применяется защита от каскадного отзыва. Роль целиком от этого не удаляется.
Адрес используемого объекта · Dependencies2 поля
TypeCodeDependencies · JSON: typeCodeстрокаДля порядкаТип цели- Назначение
- Код физического объекта Holkas, например TBP для таблицы PostgreSQL или JTB для Oracle.
- При переносе:
- Вместе с Name адресует цель ожидания Create/Update. Не заменяйте кодом класса CLS: регистрация класса не создаёт таблицу запроса. Смена метаданных адреса без изменения SQL не меняет сам запрос.
NameDependencies · JSON: nameстрокаДля порядкаАдрес цели- Назначение
- Схема и имя, например parus.udo_t_request или PARUS.UDO_T_REQUEST. Это адрес другого объекта, не имя папки.
- При переносе:
- Используется для поиска известной зависимости и команды. У функций PostgreSQL здесь одно имя без сигнатуры перегрузки. Сохраняйте адрес, полученный экспортом; зависимость удалённой базы нельзя объявить локальной одной сменой имени.
Команды плана
Четыре кода: определение и права каждой СУБД. У корня только Create/Update, у права — также Delete. Отдельных команд колонок и порядка нет.
PostgreSQL · JVP2 кода
JVPПредставление PostgreSQL
Create выполняет CREATE OR REPLACE VIEW. Update возникает при отличии Definition, Owner или Options. Обе команды передают параметры представления в WITH (...). Update сначала пробует замену на месте, при 42P16 пересоздаёт корень и допустимых местных зависимых в транзакции команды. Владелец назначается тот, что в наборе, а прежние права восстанавливаются до отдельных Grant. Изменение одних Dependencies не вызывает DDL. Самостоятельный Delete по отсутствию в наборе не формируется.
Ключ: Схема.Представление
JVP.GrantПраво · PostgreSQL
Create выдаёт привилегию, Update меняет возможность передавать её дальше, Delete отзывает отсутствующее в списке из набора право. Параметр пропуска лишних прав может убрать отзыв и снятие лишнего GRANT OPTION. Создания роли и переноса прав на отдельные колонки нет.
Ключ: Схема.Представление|Получатель:Привилегия
Oracle · JVW2 кода
JVWПредставление Oracle
Create/Update выполняет CREATE OR REPLACE FORCE VIEW со списком Columns и Definition. Update возникает при их отличии либо Valid=false приёмника. Права остаются отдельными Grant. DDL Oracle фиксируется средствами СУБД; FORCE может оставить объект невалидным. Самостоятельный Delete по отсутствию в наборе не формируется.
Ключ: Схема.Представление
JVW.GrantПраво · Oracle
Create выдаёт привилегию, Update меняет возможность передавать её дальше, Delete отзывает отсутствующее в списке из набора право. Параметр пропуска лишних прав может убрать отзыв и снятие лишнего GRANT OPTION. Создания роли и переноса прав на отдельные колонки нет.
Ключ: Схема.Представление|Получатель:Привилегия
Ограничения и что с ними делать
PostgreSQL: меняются выходные колонки
Если прежние колонки сохраняют имена, позиции, типы с размерами и правила сортировки, а новые добавляются в конец, применяется CREATE OR REPLACE VIEW. Например, добавление created_at после прежних rn, status сохраняет объект на месте.
Переименование, удаление, смена типа/сортировки либо вставка колонки перед прежней требует пересоздания. При применении Holkas сначала пробует замену; при отказе PostgreSQL 42P16 откатывает эту попытку к точке сохранения и выполняет DROP без CASCADE, затем создание. OID — внутренний идентификатор объекта — меняется. Права и местное оформление восстанавливаются в пределах описанного выше, после чего идут отдельные команды Grant.
До применения Holkas пробует новый запрос во временном представлении приёмника с откатом, сверяет колонки и показывает причину пересоздания в заметке команды и DROP в SQL. Если проба не собралась, способ выяснится при применении; заметка о неопределённости показывается, когда найдены местные зависимые. Проба не исполняет предварительно остальные команды плана.
PostgreSQL: другое представление опирается на обновляемое
Пусть местное request_totals использует udo_v_request. При совместимой замене оно остаётся на месте. При пересоздании Holkas может снять и восстановить также обычные зависимые VIEW, функции и процедуры приёмника: удаляет от дальних к ближним, создаёт обратно от ближних к дальним. Всё происходит внутри транзакции команды JVP; ошибка восстановления откатывает и удаление.
Зависимые получают прежние тексты, владельцев, права, комментарии и поддержанные местные свойства из приёмника, а не новые определения источника. Права на колонки, триггеры, правила и умолчания VIEW восстанавливаются отдельно. Если старый запрос зависимого несовместим с новым корнем, его создание может отказать и вся команда откатится.
Нельзя рассчитывать на такой путь для материализованного представления, колонки таблицы со строчным типом VIEW и иных неподдержанных видов. Предел — 20 зависимых объектов. План также предупреждает, если зависимый сам имеет команду в этом плане: перенесите корень отдельным планом, затем зависимый своим. CASCADE автоматически не добавляется. Измените структуру совместимым способом либо подготовьте пересоздание зависимых отдельно.
PostgreSQL: пересоздание ждёт занятую базу
Внутри пути пересоздания устанавливается lock_timeout = 30s: ожидание блокировки занятого корня или зависимого заканчивается отказом. Повторите применение после освобождения базы. Это предел ожидания блокировки, а не длительности всего запроса; обычная замена на месте этим кодом 30 секунд не ограничивается.
Зависимость спрятана в plpgsql или динамическом SQL
PostgreSQL отслеживает зависимости VIEW, SQL-тел и типов сигнатур, но обращение к VIEW в строковом теле plpgsql может не попасть в каталог местных зависимых. Например, функция с SELECT status FROM udo_v_request внутри такого тела после удаления status способна сломаться лишь при вызове. Проверьте используемые процедуры и запросы отдельно; отсутствие предупреждения не подтверждает их совместимость.
Oracle также не даёт полного каталога для динамического SQL и удалённых ссылок. Dependencies не является проверкой произвольной программы и не переводит её между СУБД.
Oracle: объект есть, но запрос не выполняется
CREATE OR REPLACE FORCE VIEW позволяет сохранить определение без всех доступных опор. Например, при отсутствующей таблице VIEW может остаться INVALID. Финальный этап пробует пересборку схемы и называет оставшиеся невалидные объекты; исправьте отсутствующую опору или SQL. Успех записи определения сам по себе не подтверждает чтение списка в Парусе.
Грант при ORA-04063 откладывается до финального этапа, после компиляции. DDL Oracle фиксируется самой СУБД: успешная замена VIEW не откатится вместе с последующей ошибкой выдачи права. Общая транзакция PostgreSQL здесь не обещается.
Oracle: многострочные литералы переносятся точно
Вне литералов Holkas не считает различием хвостовые пробелы строк, CRLF вместо LF и пустые строки по краям: такое форматирование не создаёт Update. Текст в кавычках сохраняется точно: в выражении ниже после A два пробела перед переводом строки, и в приёмнике строка остаётся из пяти символов. То же относится к q'[…]', CR внутри литерала и идентификаторам в двойных кавычках.
SELECT 'A
B' FROM DUALЗапрос выполняется, но список раздела Паруса работает неверно
Клиентское представление КОР должно выдавать ключ записи, применимые поля деления, каталога и master-раздела; одна запись основной таблицы должна встречаться не больше одного раза. Например, соединение заявки с несколькими строками деталей без нужной обработки может показать заявку несколько раз.
Проверьте состав запроса, проверку доступа к каждой записи и соответствия колонок атрибутам VIW. Holkas не доказывает эти требования по одному успешному CREATE VIEW или GRANT SELECT. Настройки представления класса →
Право уже передано другим пользователям
Например, роль reader получила SELECT WITH GRANT OPTION и выдала SELECT роли analyst. Снятие у reader права или возможности передавать его дальше затрагивает analyst. Holkas защищает от такого каскадного отзыва; сначала согласуйте цепочку прав. Настройка пропуска лишних прав сохраняет лишний грант и лишнюю возможность передачи, но не создаёт отсутствующую роль.
Регистрация PostgreSQL в справочнике конвертера Паруса
После применения объекта Holkas регистрирует VIEW и его колонки в справочнике sys.ppc$cnv$*, если справочник доступен. Если его нет, этот этап пропускается. Регистрация не создаёт представление класса VIW и не восстанавливает зависимости, права и вложенные функции, которые вычислял конвертер Oracle → PostgreSQL. Общие границы регистрации →
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше.
Учебный запрос читает rn из новой таблицы. После пустой оболочки Create TBP нужно добавить колонку, и только затем создавать VIEW.
Create TBP.ColCreate JVPНиже 14 правил: собственные опоры запроса, права, непосредственные потребители физического VIEW и скрипты автора. Внутреннее пересоздание местных зависимых при Update PostgreSQL разобрано в ограничениях; оно не становится отдельным списком команд.
Запрос PostgreSQLПравил: 4
Create / Update TBP, JVP, JFP, JPP, SQP, CTP→Create / Update JVPКогда: У изменяемого JVP есть ненулевой Dependencies и сохранённая ссылка на цель.
Настоящие зависимости по каталогу источника: запрос должен дождаться создания или обновления используемого объекта. Другое JVP — такое же ожидание; ссылка не становится частью определения этого VIEW.
Create / Update TBP.Col→Create / Update JVPКогда: JVP ссылается на TBP, и её описание доступно в наборе.
Сначала долить все колонки таблицы из набора: Create TBP создаёт пустую оболочку. Рёбра колонок только для порядка — совпавшая колонка без команды не считается недостающей.
Create / Update CTP.Item→Create / Update JVPКогда: JVP ссылается на CTP, его описание доступно в наборе.
Составной тип также создаётся оболочкой и дополняется частями. Ожидания его элементов только упорядочивают реальные команды.
Create / Update кандидата TBP, JVP, JFP, JPP, SQP, CTP→Create / Update JVPКогда: Dependencies=null: старый файл без каталога зависимостей.
Кандидаты имён извлекаются из Definition с вариантами схемы. Рёбра только для порядка при совпадении; отсутствие кандидата не доказывает недостающий объект. Правила доливки TBP/CTP применяются и здесь. При [] скана нет.
Права после определенияПравил: 1
Create / Update JVP или JVW→Create / Update / Delete JVP.Grant или JVW.GrantКогда: Есть изменение права соответствующего представления.
Даже отзыв ждёт корень: после пересоздания PostgreSQL восстанавливает прежние права как исходное состояние для команд Grant. Правка только прав не требует повторного DDL представления.
Запрос и права OracleПравил: 3
Create / Update объекта из Dependencies→Create / Update JVW и JVW.GrantКогда: Сохранённые зависимости Oracle доступны в описании из набора.
Сохранённые ссылки становятся ожиданиями команд представления, в том числе команд прав. Отсутствующая известная опора участвует в предупреждениях; FORCE не делает её ненужной. Команда Delete права таких ожиданий не получает.
Create / Update JTB.Col→Create / Update JVW и JVW.GrantКогда: Dependencies указывает JTB и в плане есть команды добавления/изменения её колонок.
Ждать не только таблицу, но и реальные изменения её колонок. У нового JTB колонки сразу входят в Create корня.
Create / Update сохранённой опоры→Команда, ссылающаяся на совпавший объект OracleКогда: Описание промежуточного объекта с Dependencies есть в наборе, его корневой команды нет.
Цепочка зависимостей продолжается через совпавшее JVW/другой Oracle-объект; для встреченной JTB добавляются ожидания команд её колонок, имеющихся в плане. Если промежуточного описания нет в наборе, его зависимости неизвестны и цепочка на нём обрывается.
Непосредственные потребители представленияПравил: 4
Create / Update JVP→Create / Update JFP / JPPКогда: Распознан тип представления в сигнатуре или declare-секции функции/процедуры PostgreSQL.
Известное источнику имя даёт настоящую зависимость, прочий кандидат — только порядок. Произвольный SELECT внутри plpgsql не означает такое ребро; динамический SQL этим правилом не проверяется.
Create / Update JVW→Create / Update зависимого объекта OracleКогда: Каталожные Dependencies функции, процедуры, представления, пакета или триггера указывают JVW.
Потребитель ставится после представления; если представление совпало, а его описание есть в наборе, потребитель ждёт и его опоры. Это не автоматический Update всех неизменившихся потребителей.
Create / Update JVP или JVW→Create / Update VIWКогда: Представление класса использует физический VIEW: CustomQuery не равен 1.
Адрес — parus.ViewName на PostgreSQL или PARUS.VIEWNAME на Oracle. Сначала физическое определение, потом регистрация класса. При собственном QuerySql (CustomQuery=1) такой ссылки нет.
Create / Update JVP или JVW→Create / Update VIW.Attr / VIW.ParamКогда: Физический режим и в этом плане нет Create VIW; создаётся либо меняется часть.
Часть ждёт VIEW сама, а не через корень. При Create VIW новая часть ждёт корень и через него VIEW. Параметры допускаются Парусом только для собственного запроса; ветвь VIW.Param при физическом режиме не доказывает допустимость противоречивого файла.
Скрипты автораПравил: 2
SCR Before→Охваченные JVP / JVW и их GrantКогда: Приёмник исполняет скрипты; область скрипта включает VIEW либо весь перенос.
Скрипт выполняется до охваченных команд. Это отдельный объект со своим SQL, не часть Definition.
Охваченные JVP / JVW и их Grant→SCR AfterКогда: Та же область, время After.
Скрипт выполняется после охваченных команд; если таких команд нет, он исключается из плана. Порядок списка прав или колонок этим не задаётся.
Границы графа
Это каталог правил, а не число рёбер в каждом плане. Зависимость связывает выбранные команды; известная опора также может быть названа как недостающая. Расширение плана при разрешении зависимостей не равно безусловному включению всех опор в первоначальную выгрузку. Рёбра только для порядка не требуют команд для совпавших частей.
Dependencies описывает опоры запроса источника. Местные объекты, мешающие DROP в PostgreSQL, исследуются отдельно по приёмнику; их пересоздание происходит внутри Update JVP, без отдельных команд этих объектов. Текст plpgsql и динамический SQL не дают полного графа. Источник данных в настройках MEC ссылается на представление класса (VIW), а не на JVW/JVP напрямую: физический объект называет уже сама VIW. Разбор недостающих зависимостей →
Как представление хранится в файлах
Один VIEW — один файл с его правами и адресами зависимостей. В проверенных выгрузках JVP/JVW устройство объекта в двух ZIP совпало; это наблюдение именно об этих типах, а не обо всех объектах Holkas.
Git
YAMLViewPostgres/parus.udo_v_request.yamlSQL — обычная строка Definition, права — список Grants, адреса опор — Dependencies.
Oracle:ViewOracle/PARUS.UDO_V_REQUEST.yaml. В корне репозитория — .holkas.S3
JSON в ZIPViewPostgres/parus.udo_v_request.jsonОдин JSON внутри архива. Все переносимые свойства VIEW находятся в нём.
Oracle:ViewOracle/PARUS.UDO_V_REQUEST.json. В корне архива — manifest.json.Файл пакета
JSON в ZIPViewPostgres/parus.udo_v_request.jsonСкачиваемый ZIP содержит такой же JSON этого объекта; права отдельными файлами не выделяются.
Oracle:ViewOracle/PARUS.UDO_V_REQUEST.json. В корне архива — manifest.json.Манифест перечисляет JVP/JVW, полное имя и платформу пакета. Dependencies хранит только код типа и адрес; определения этих объектов будут в собственных файлах, если их включили в выгрузку. SQL не записывается в Base64. Null-поля опускаются; пустые списки и true сохраняются. Valid Oracle во всех трёх вариантах отсутствует; Owner Oracle равен null и также опущен.
PostgreSQL: те же поля в Git YAML и JSON обоих ZIP
Ниже учебное полное описание одного VIEW, проверенное чтением в Holkas. Оно не создаёт используемую таблицу и роль reader: они должны быть подготовлены отдельно. Названия подобраны для примера.
Git — ViewPostgres/parus.udo_v_request.yaml
Schema: parus
Name: udo_v_request
Definition: SELECT rn, status FROM parus.udo_t_request
Grants:
- Grantee: reader
Privilege: SELECT
WithGrantOption: true
Owner: parus
Dependencies:
- TypeCode: TBP
Name: parus.udo_t_request
Options:
- security_barrier=true
S3 или «Файл пакета» — ViewPostgres/parus.udo_v_request.json
{
"schema": "parus",
"name": "udo_v_request",
"definition": "SELECT rn, status FROM parus.udo_t_request",
"grants": [
{ "grantee": "reader", "privilege": "SELECT", "withGrantOption": true }
],
"owner": "parus",
"dependencies": [ { "typeCode": "TBP", "name": "parus.udo_t_request" } ],
"options": [ "security_barrier=true" ]
}
Oracle: имена колонок отдельно от текста SELECT
Сокращённые учебные фрагменты, не готовые файлы загрузки: Grants и Dependencies здесь опущены. Полный экспорт содержит эти списки; переносимый список Grants нельзя заменять на [] ради сокращения примера.
Git — ViewOracle/PARUS.UDO_V_REQUEST.yaml
Schema: PARUS
Name: UDO_V_REQUEST
Columns:
- NRN
- SSTATUS
Definition: SELECT T.RN, T.STATUS FROM PARUS.UDO_T_REQUEST T
S3 или «Файл пакета» — ViewOracle/PARUS.UDO_V_REQUEST.json
{
"schema": "PARUS",
"name": "UDO_V_REQUEST",
"columns": [ "NRN", "SSTATUS" ],
"definition": "SELECT T.RN, T.STATUS FROM PARUS.UDO_T_REQUEST T"
}
Из такого определения при применении строится заголовок CREATE OR REPLACE FORCE VIEW … (NRN, SSTATUS) AS …. Список имён не восстанавливается по одному T.RN: имя NRN задано отдельно. Для правки используйте полный экспорт и сохраняйте порядок Columns.
Практические шаги: Git, выгрузка и загрузка ZIP. Оглавление ZIP и обязательные списки — в справке о пакете.
Основа: руководство КОР Парус 8, издание 2026, с. 13, 17, 90–91 (назначение клиентских представлений, доступ и регистрация класса); текущие DTO, каталоги СУБД, построители команд, исполнители и файловые транспорты Holkas 0.1.30. Сверено 9 ноября 2026. Примеры учебные; файловые писатели, читатели и планы проверены локально. Новый перенос в PostgreSQL/Oracle и работа клиентов Паруса для этой страницы не выполнялись.