Структура базы · PostgreSQL и Oracle
Таблица хранит строки раздела. Holkas переносит её устройство: например, добавляет колонку статуса, ключ и проверку допустимой суммы в таблицу заявок.
TBP / JTB + Схема.ТаблицаФизическая таблица и раздел Паруса
Таблица — объект самой СУБД. У неё есть колонки, ключи, проверки, индексы, триггеры и права. Учебная parus.udo_t_request хранит заявки: rn — номер, status — статус. Добавление новой колонки меняет устройство таблицы; конкретные заявки источника в приёмнике от этого не появляются.
В Holkas таблицы разных СУБД имеют разные типы: TBP — PostgreSQL, JTB — Oracle. Описание JTB · PARUS.UDO_T_REQUEST не переводится автоматически в TBP · parus.udo_t_request. Для каждого приёмника нужен подходящий физический объект и SQL его платформы.
Класс КОР описывает раздел Паруса и его атрибуты, а регистрация TABLELIST — сведения Паруса о таблице. Ни одна из этих записей сама по себе не создаёт физическую таблицу. Объект реестра класса CLO также хранит описание и текст, а не выполняет этот перенос структуры. Строки справочника решения переносит отдельный набор данных DAT.
Что входит в перенос
TBP / JTBТаблицаСхема, имя, комментарий; у PostgreSQL — роль-владелец, у Oracle — режим хранения строкColumnsКолонкиТипы, размеры, NULL и умолчания; у PostgreSQL также сортировка, у Oracle — комментарииConstraintsОграниченияКлючи и проверки значений, ссылки на другие таблицыIndexesИндексыСамостоятельные способы поиска и проверки уникальностиTriggersТриггерыСобытия таблицы, обработчик и состояниеGrantsПраваПолучатель, привилегия и возможность передавать её дальше
Выбор таблицы загружает все её переносимые части. Функция триггера PostgreSQL не вложена в таблицу: включайте JFP отдельно, даже если функция уже есть, но её код изменился. Целевые таблицы FK, последовательности умолчаний, классы и представления также выбираются отдельно. Связи между командами помогают с порядком, а не расширяют выгрузку до всей базы автоматически.
Create TBP создаёт пустую оболочку, затем идут Create TBP.Col. Oracle не создаёт таблицу без колонок: Create JTB включает сразу весь список Columns. Ограничения, индексы, триггеры и права в обоих случаях создаются отдельными командами.Справочник полей
75 полей · 11 группПоля таблицы и её частей для двух СУБД. Общие поля права показаны один раз. Имена с большой буквы соответствуют Git YAML, JSON начинается с маленькой. Служебные Owner Oracle и Valid отмечены отдельно; это не дополнительные настройки файла.
Как читать обозначения
Подсказка значка открывается мышью, клавишей Tab или нажатием.
Ключ задаёт сопоставление таблицы или части; «Сравнивается» означает обнаруживаемую разницу, а не гарантию допустимости SQL. Списки сравниваются по своим ключам. Create/Update корня не заменяет отдельные команды частей; исключение — колонки нового или пересоздаваемого JTB.
Таблица PostgreSQL · TBP9 полей
SchemaTBP · JSON: schemaстрокаЧасть ключаСхема таблицы- Назначение
- Пространство имён, например parus; вместе с TableName задаёт адрес parus.udo_t_request.
- При переносе:
- Смена адреса описывает другую таблицу. При её отсутствии возникает Create; прежняя таблица и её строки автоматически не удаляются. Сама схема этой командой не создаётся.
TableNameTBP · JSON: tableNameстрокаЧасть ключаИмя таблицы- Назначение
- Имя физической таблицы без префикса схемы, например udo_t_request.
- При переносе:
- У нового имени — новое сопоставление, а не ALTER TABLE RENAME. Данные старой таблицы в новую не перекладываются. Сохраняйте согласованность имён в SQL-фрагментах индексов и триггеров.
OwnerTBP · JSON: ownerстрокаСравниваетсяРоль-владелец- Назначение
- Роль PostgreSQL, владеющая объектом; может отличаться от Schema.
- При переносе:
- При Create и изменении владельца выполняется OWNER TO — при Create всегда, даже если Owner совпадает со Schema: PostgreSQL отдаёт новую таблицу роли подключения. Нужная роль должна существовать, а роль подключения — иметь право её назначить. Замена владельцев настраивается параметрами переноса. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется. Это не перенос пользователей и не изменение схемы объекта.
CommentTBP · JSON: commentстрока / nullСравниваетсяКомментарий таблицы- Назначение
- Пояснение в каталоге СУБД. Это не наименование регистрации TABLELIST в Парусе.
- При переносе:
- Разница даёт Update TBP. Непустой текст записывается, null очищает прежний комментарий. Null и пустая строка при сравнении равны; это не правило «оставить старое».
ColumnsTBP · JSON: columnsсписокПо элементамКолонки- Назначение
- Имена, типы, обязательность и выражения по умолчанию.
- При переносе:
- Сопоставляются по ColumnName. Новые добавляются, отличающиеся изменяются; отсутствующие сохраняются. Перестановка массива не переставляет физические колонки. При пересоздании Oracle сохраняются только колонки из описания в источнике.
ConstraintsTBP · JSON: constraintsсписокПо элементамОграничения- Назначение
- Первичные и уникальные ключи, внешние ключи и проверки строк.
- При переносе:
- Сопоставляются по ConstraintName. Create добавляет, Update снимает и создаёт заново одной командой, Delete снимает отсутствующее. [] может снять все переносимые ограничения.
IndexesTBP · JSON: indexesсписокПо элементамИндексы- Назначение
- Самостоятельные индексы; обслуживающие первичный и уникальный ключи не дублируются в этом списке.
- При переносе:
- Ключ — IndexName. Изменение определения даёт Update со снятием и созданием. Отсутствующий индекс удаляется; [] может снять все индексы этого списка.
TriggersTBP · JSON: triggersсписокПо элементамТриггеры- Назначение
- Привязки обработчиков к событиям таблицы; состав различается у PostgreSQL и Oracle.
- При переносе:
- Сопоставляются по TriggerName. Новые создаются, изменённые обновляются, отсутствующие удаляются. [] снимает все переносимые триггеры; прикладные изменения строк после этого могут перестать проверяться.
GrantsTBP · JSON: grantsсписокПо элементамПрава на таблицу- Назначение
- Явные разрешения получателям. Членство пользователей в ролях сюда не входит.
- При переносе:
- Ключ — Grantee:Privilege. Create выдаёт право, Delete отзывает, Update меняет возможность передать его дальше. Параметр «Пропускать лишние права в приёмнике» сохраняет лишние права и их GRANT OPTION; иначе [] может дать отзывы.
Колонка PostgreSQL · TBP.Col9 полей
ColumnNameTBP.Col · JSON: columnNameстрокаКлючИмя колонки- Назначение
- Имя внутри таблицы, например status.
- При переносе:
- Смена status на state добавляет новую колонку state и сохраняет status вместе с её данными. Автоматического переименования и переноса значений нет.
TypeTBP.Col · JSON: typeстрокаСравниваетсяТип PostgreSQL- Назначение
- Каталожное имя pg_type, например int4, numeric, varchar, text; перечень поддержанных типов приведён в примечании.
- При переносе:
- Create задаёт тип, Update выполняет ALTER COLUMN TYPE без собственного USING для преобразования строк. Пользовательский тип или jsonb Holkas сейчас отклоняет при формировании SQL. Тип Oracle по этому полю не выводится.
NullableTBP.Col · JSON: nullableлогическоеСравниваетсяРазрешён ли NULL- Назначение
- true допускает незаполненное значение, false требует значение в каждой строке.
- При переносе:
- Создание ставит NOT NULL при false; Update меняет требование. Если в существующих строках есть NULL, включение NOT NULL может быть отвергнуто СУБД. Default не заполняет старые NULL автоматически при такой смене.
DefaultTBP.Col · JSON: defaultстрока / nullСравниваетсяВыражение по умолчанию- Назначение
- SQL-выражение, например 0 или nextval('parus.seq_request'::regclass), а не готовое значение каждой строки.
- При переносе:
- Создание добавляет DEFAULT; Update меняет его либо выполняет DROP DEFAULT для null/пустого текста. Изменение умолчания не переписывает прежние строки. Распознанная последовательность даёт ожидание её Create, но сама в состав не включается.
CharMaxLengthTBP.Col · JSON: charMaxLengthцелое / nullСравниваетсяДлина строки- Назначение
- Размер char/varchar, например 20. Для text ограничение длины здесь не задаётся.
- При переносе:
- Участвует в формировании типа и его изменении. Null для varchar и bpchar означает отсутствие ограничения длины, а для char — длину 1, как в SQL; ноль — отдельное число, а не отсутствие размера. Уменьшение может не пройти на существующих строках.
NumericPrecisionTBP.Col · JSON: numericPrecisionцелое / nullСравниваетсяТочность числа- Назначение
- Число цифр numeric; каталог также сообщает сведения точности некоторых встроенных числовых типов.
- При переносе:
- Для numeric задаёт numeric(p) или numeric(p,s). Для int4 и иных типов без модификаторов эти сведения не дописываются к SQL-типу, хотя отличие в модели может дать Update.
NumericScaleTBP.Col · JSON: numericScaleцелое / nullСравниваетсяМасштаб числа- Назначение
- Число знаков после запятой numeric, например 2 при numeric(12,2).
- При переносе:
- Вместе с NumericPrecision формирует тип. При заданной точности null равен 0: numeric(12) и numeric(12,0) — один тип, и повторного Update не будет. Приведение существующих значений выполняет PostgreSQL, Holkas не рассчитывает их заново. С PostgreSQL 15 масштаб может быть отрицательным: numeric(12,-2) переносится как есть. Пакеты и снимки git, снятые версией 0.1.34 или более ранней, записали такой масштаб как 2046: выгрузите их заново.
DatetimePrecisionTBP.Col · JSON: datetimePrecisionцелое / nullСравниваетсяТочность времени- Назначение
- Заданное число знаков дробных секунд у timestamp и timestamptz, например 0 у timestamp(0) или 3 у timestamptz(3). У массива timestamp(3)[] — точность элемента. Null — модификатора нет: точность PostgreSQL по умолчанию, шесть знаков.
- При переносе:
- Дописывается к типу при создании колонки, а её изменение даёт Update со сменой типа. Уменьшение точности PostgreSQL выполняет округлением уже сохранённых значений. Файлы, снятые до появления поля, его не содержат и означают «без модификатора».
CollationTBP.Col · JSON: collationстрока / nullСравниваетсяПравило сортировки- Назначение
- Явное правило сортировки текстовой колонки в виде схема.имя: например, pg_catalog.C для code text COLLATE "C". Null — правило типа по умолчанию, то есть сортировка базы, или тип без сортировки, как int4.
- При переносе:
- Дописывается к типу колонки как COLLATE при создании; разница даёт Update TBP.Col через ALTER COLUMN TYPE, а null возвращает правило по умолчанию. Индексы на колонке PostgreSQL при этом перестраивает сам. Правило должно существовать в базе-приёмнике. Файлы, снятые до появления поля, его не содержат и означают «по умолчанию».
Ограничение PostgreSQL · TBP.Cns8 полей
ConstraintNameTBP.Cns · JSON: constraintNameстрокаКлючИмя ограничения- Назначение
- Имя внутри выбранной таблицы; например pk_request.
- При переносе:
- Новое имя даёт Delete прежнего и Create нового ограничения. При прежнем имени изменение полей даёт один Update, внутри которого DROP и ADD.
TypeTBP.Cns · JSON: typeстрокаСравниваетсяВид ограничения- Назначение
- Код каталога: p — первичный ключ, u — уникальность, f — внешний ключ, c — проверка CHECK, x — исключение EXCLUDE.
- При переносе:
- Используется при сравнении и для порядка самоссылки FK. Сам SQL создаётся из ConstraintValue: смена одного Type без согласованного текста не переписывает определение корректно.
ColumnsTBP.Cns · JSON: columnsстрокаСравниваетсяСвои колонки- Назначение
- Список имён через запятую для порядка команд, например rn,status. При чтении из каталога базы порядок колонок ключа сохраняется.
- При переносе:
- Ожидание Create каждой названной колонки. При сравнении этого списка порядок имён несущественен; настоящий порядок ключа задаёт ConstraintValue. У CHECK без колонок каталог даёт пустую строку.
SchemaRefTBP.Cns · JSON: schemaRefстрока / nullСравниваетсяСхема цели FK- Назначение
- Схема таблицы, на которую ссылается внешний ключ.
- При переносе:
- Вместе с TableRef задаёт ожидание Create целевой TBP. Используется для графа; SQL-ссылка находится в ConstraintValue. При отсутствии пары такого ребра нет.
TableRefTBP.Cns · JSON: tableRefстрока / nullСравниваетсяТаблица цели FK- Назначение
- Имя таблицы цели отдельно от схемы.
- При переносе:
- Смена должна быть согласована с ConstraintValue, ColumnsRef и ConstraintRef. Ожидание Create таблицы не означает ожидания всех её Update или автоматического включения таблицы в экспорт.
ColumnsRefTBP.Cns · JSON: columnsRefстрока / nullСравниваетсяКолонки цели FK- Назначение
- Список имён целевых колонок через запятую.
- При переносе:
- Каждая даёт ожидание Create TBP.Col цели. Порядок списка несущественен для сравнения метаданных; порядок соответствия колонок SQL задаёт ConstraintValue.
ConstraintValueTBP.Cns · JSON: constraintValueстрокаСравниваетсяОпределение ограничения- Назначение
- Полный фрагмент после ADD CONSTRAINT имя: например PRIMARY KEY (rn), CHECK (amount >= 0) или FOREIGN KEY … REFERENCES ….
- При переносе:
- Этот текст исполняется при Create и после DROP при Update. Здесь находятся реальный порядок ключа, режимы проверки и действия FK. Наличие полей Columns/Type не заменяет согласованное определение.
ConstraintRefTBP.Cns · JSON: constraintRefстрока / nullСравниваетсяИмя ключа цели- Назначение
- Ключ цели FK для порядка команд. Чтение заполняет его только для PRIMARY KEY; у FK на UNIQUE и в старых файлах поле пустое.
- При переносе:
- Непустое имя даёт ожидание Create целевого TBP.Cns. При пустом имени FK на другую таблицу ждёт её PRIMARY KEY или UNIQUE с тем же набором колонок, что ColumnsRef. У самоссылки есть отдельное ожидание всех своих p/u.
Индекс PostgreSQL · TBP.Idx3 поля
IndexNameTBP.Idx · JSON: indexNameстрокаКлючИмя индекса- Назначение
- Имя самостоятельного индекса, например ix_request_status.
- При переносе:
- Смена имени даёт Delete/Create. При прежнем имени отличие даёт один Update, который снимает индекс и создаёт заново; прежнее утверждение «индексы не обновляются» здесь не действует.
ColumnsTBP.Idx · JSON: columnsстрокаСравниваетсяИспользуемые колонки- Назначение
- Перечень имён для рёбер. Каталог учитывает также ссылки выражений на колонки и сортирует имена по алфавиту.
- При переносе:
- Команда ждёт Create этих TBP.Col. Это не SQL-порядок полей индекса: его, выражения, DESC и условие WHERE задаёт IndexValue. Порядок этой строки сам по себе сравнивается.
IndexValueTBP.Idx · JSON: indexValueстрокаСравниваетсяSQL индекса без CREATE- Назначение
- Фрагмент pg_indexes.indexdef после снятия первого CREATE, например INDEX … ON parus.udo_t_request USING btree (status).
- При переносе:
- При записи Holkas добавляет CREATE. Имя, таблица, уникальность, метод, выражения и фильтр берутся из текста; ручная смена только IndexName или Columns не переписывает этот SQL.
Триггер PostgreSQL · TBP.Trg5 полей
TriggerNameTBP.Trg · JSON: triggerNameстрокаКлючИмя триггера- Назначение
- Имя привязки к событию внутри таблицы.
- При переносе:
- Смена имени даёт Delete/Create. Тело функции остаётся отдельным JFP; удаление триггера не удаляет функцию.
EnableTBP.Trg · JSON: enableстрокаСравниваетсяРежим срабатывания- Назначение
- O — обычный ENABLE; R — ENABLE REPLICA; A — ENABLE ALWAYS; D — DISABLE.
- При переносе:
- Создаёт ли Holkas триггер заново или переносит его SQL-файлом, режим сохраняется: после CREATE TRIGGER отдельно выполняется DISABLE, ENABLE REPLICA или ENABLE ALWAYS, для O ничего не добавляется. Если изменился только режим, а TriggerValue прежний, Update меняет режим, не пересоздавая триггер.
SchemaTriggerFunctionTBP.Trg · JSON: schemaTriggerFunctionстрока / nullСравниваетсяСхема обработчика- Назначение
- Схема функции; каталог также возвращает уже полное имя в TriggerFunction.
- При переносе:
- Дополняет имя для ребра, только если в TriggerFunction ещё нет точки. Не меняет текст TriggerValue. Не трактуйте отдельную правку этого поля как смену исполняемой функции.
TriggerFunctionTBP.Trg · JSON: triggerFunctionстрока / nullСравниваетсяФункция-обработчик- Назначение
- Обычно квалифицированное имя parus.f_request. Функция содержит бизнес-логику срабатывания.
- При переносе:
- Create/Update триггера ждут Create и Update соответствующего JFP. Функцию выбирайте отдельно, даже когда таблица полностью совпадает: старое тело имеющейся функции не вызывает предупреждения о недостающей зависимости.
TriggerValueTBP.Trg · JSON: triggerValueстрокаСравниваетсяSQL триггера без CREATE- Назначение
- Фрагмент pg_get_triggerdef после первого CREATE: событие, таблица, условие и вызов функции.
- При переносе:
- Create добавляет CREATE; при отличии текста Update выполняет DROP/CREATE, иначе меняет Enable. Функция, фактически вызываемая PostgreSQL, определяется этим текстом, а не только полем TriggerFunction.
Таблица Oracle · JTB10 полей
SchemaJTB · JSON: schemaстрокаЧасть ключаСхема-владелец- Назначение
- Например PARUS. В Oracle схема определяет владельца таблицы.
- При переносе:
- Вместе с TableName задаёт адрес. Отдельный перенос роли-владельца как у PostgreSQL не выполняется; схема должна быть подготовлена. При применении Holkas устанавливает текущую схему сеанса перед DDL.
TableNameJTB · JSON: tableNameстрокаЧасть ключаИмя таблицы- Назначение
- Имя без схемы, например UDO_T_REQUEST.
- При переносе:
- Новое имя описывает другую таблицу, а не переименование; прежняя не удаляется по отсутствию в наборе. Данные между старой и новой таблицами не копируются.
CommentJTB · JSON: commentстрока / nullСравниваетсяКомментарий таблицы- Назначение
- Текст каталога ALL_TAB_COMMENTS.
- При переносе:
- Create записывает, Update меняет либо очищает при null; пустая строка в файле означает то же, что null. Update корня меняет только этот комментарий: комментарии колонок существующей таблицы пишут их команды JTB.Col.
PersistenceJTB · JSON: persistenceперечислениеСравниваетсяВремя жизни строк- Назначение
- Permanent — постоянная; Transaction — GLOBAL TEMPORARY ON COMMIT DELETE ROWS; Session — GLOBAL TEMPORARY ON COMMIT PRESERVE ROWS.
- При переносе:
- Изменение существующего режима даёт Update JTB с DROP/CREATE: строки и все прежние колонки исчезают, части создаются заново по спискам из источника. YAML хранит название, JSON — 0/1/2. Старый файл без поля означает Permanent.
ColumnsJTB · JSON: columnsсписокПо элементамКолонки- Назначение
- Имена, типы, обязательность и выражения по умолчанию.
- При переносе:
- Сопоставляются по ColumnName. Новые добавляются, отличающиеся изменяются; отсутствующие сохраняются. Перестановка массива не переставляет физические колонки. При пересоздании Oracle сохраняются только колонки из описания в источнике.
ConstraintsJTB · JSON: constraintsсписокПо элементамОграничения- Назначение
- Первичные и уникальные ключи, внешние ключи и проверки строк.
- При переносе:
- Сопоставляются по ConstraintName. Create добавляет, Update снимает и создаёт заново одной командой, Delete снимает отсутствующее. [] может снять все переносимые ограничения.
IndexesJTB · JSON: indexesсписокПо элементамИндексы- Назначение
- Самостоятельные индексы; обслуживающие первичный и уникальный ключи не дублируются в этом списке.
- При переносе:
- Ключ — IndexName. Изменение определения даёт Update со снятием и созданием. Отсутствующий индекс удаляется; [] может снять все индексы этого списка.
TriggersJTB · JSON: triggersсписокПо элементамТриггеры- Назначение
- Привязки обработчиков к событиям таблицы; состав различается у PostgreSQL и Oracle.
- При переносе:
- Сопоставляются по TriggerName. Новые создаются, изменённые обновляются, отсутствующие удаляются. [] снимает все переносимые триггеры; прикладные изменения строк после этого могут перестать проверяться.
GrantsJTB · JSON: grantsсписокПо элементамПрава на таблицу- Назначение
- Явные разрешения получателям. Членство пользователей в ролях сюда не входит.
- При переносе:
- Ключ — Grantee:Privilege. Create выдаёт право, Delete отзывает, Update меняет возможность передать его дальше. Параметр «Пропускать лишние права в приёмнике» сохраняет лишние права и их GRANT OPTION; иначе [] может дать отзывы.
OwnerJTB · JSON: не сохраняетсявычисляемое nullНе задаётсяОтдельный владелец- Назначение
- Служебное свойство общей модели прав: для Oracle всегда null.
- При переносе:
- В Git и JSON с опусканием null не записывается; задаваемым реквизитом JTB не является. Владельца определяет Schema. Редактировать Owner в файле вместо Schema бессмысленно.
Колонка Oracle · JTB.Col9 полей
ColumnNameJTB.Col · JSON: columnNameстрокаКлючИмя колонки- Назначение
- Имя внутри таблицы, например STATUS.
- При переносе:
- Новая колонка существующей таблицы даёт Create JTB.Col; в новой или пересоздаваемой таблице входит в JTB. Смена имени обычно оставляет прежнюю колонку и добавляет новую; при пересоздании остаются только колонки из источника.
DataTypeJTB.Col · JSON: dataTypeстрокаСравниваетсяТип Oracle- Назначение
- Каталожный тип: NUMBER, VARCHAR2, DATE, CLOB, TIMESTAMP(6) и другие.
- При переносе:
- При записи тип приводится к верхнему регистру. Размер дописывается только известным размерным типам; у DATE/CLOB и TIMESTAMP(6) длина повторно не добавляется. PostgreSQL-тип из него не переводится.
LengthJTB.Col · JSON: lengthцелое / nullСравниваетсяДлина- Назначение
- Для строки — CHAR_LENGTH, при его нуле — DATA_LENGTH; для RAW это байты.
- При переносе:
- Используется для CHAR, VARCHAR/VARCHAR2, NCHAR/NVARCHAR2 и RAW при положительном значении. Для NUMBER размер задают Precision/Scale, а не Length. Каталожная длина иных типов сохраняется, но в DDL к ним не дописывается.
PrecisionJTB.Col · JSON: precisionцелое / nullСравниваетсяТочность- Назначение
- Число цифр NUMBER либо точность FLOAT.
- При переносе:
- Формирует NUMBER(p,s), NUMBER(p) или FLOAT(p). Null для NUMBER даёт NUMBER без параметров; не заменяйте его нулём. Изменение существующей колонки выполняется MODIFY и может ограничиваться её данными.
ScaleJTB.Col · JSON: scaleцелое / nullСравниваетсяМасштаб NUMBER- Назначение
- Число знаков после запятой; 0 означает целое в заданной точности.
- При переносе:
- Используется у NUMBER с непустой Precision; при её отсутствии записывается просто NUMBER. Отличие поля всё равно учитывает план. Допустимость преобразования проверяет Oracle.
CharUsedJTB.Col · JSON: charUsedстрока / nullСравниваетсяЕдиница длины строки- Назначение
- C — символьная семантика, B — байтовая.
- При переносе:
- У VARCHAR2/CHAR/VARCHAR единица пишется явно: C — CHAR, B — BYTE, поэтому результат не зависит от NLS_LENGTH_SEMANTICS приёмника. Если значения нет (null), единица не пишется и Oracle берёт её из сеанса. У NVARCHAR2/NCHAR и RAW единицы не бывает.
NullableJTB.Col · JSON: nullableлогическоеСравниваетсяРазрешён ли NULL- Назначение
- true — NULL допустим; false — NOT NULL.
- При переносе:
- У новой колонки требование входит в определение; MODIFY меняет его только при отличии, чтобы не повторять NOT NULL. Включение на незаполненных строках может быть отвергнуто Oracle.
DefaultJTB.Col · JSON: defaultстрока / nullСравниваетсяВыражение по умолчанию- Назначение
- Текст DATA_DEFAULT: например 0, SYSDATE или последовательность.NEXTVAL.
- При переносе:
- При Create любое значение, отличное от null, подставляется как SQL: пустая строка не является корректным выражением. При смене на null MODIFY задаёт DEFAULT NULL. Пробелы и переводы строк вне литералов не считаются различием; текст в кавычках сохраняется как есть. Само наличие выражения не даёт ребра JTB.Col к последовательности или функции.
CommentJTB.Col · JSON: commentстрока / nullСравниваетсяКомментарий колонки- Назначение
- Текст ALL_COL_COMMENTS. У PostgreSQL в этой модели аналогичного поля колонки нет.
- При переносе:
- В новой или пересоздаваемой таблице записывается вместе с CREATE корня. У существующей таблицы JTB.Col пишет комментарий после ADD или MODIFY; null или пустая строка снимает прежний текст. Если изменился только комментарий, колонка не переопределяется.
Ограничение Oracle · JTB.Cns12 полей
ConstraintNameJTB.Cns · JSON: constraintNameстрокаКлючИмя ограничения- Назначение
- Имя ограничения; системно именованные ограничения текущий каталог не читает.
- При переносе:
- Смена имени даёт Delete/Create; при прежнем имени разница даёт Update с DROP и ADD. Автоматические NOT NULL уже отражены в Nullable колонки.
TypeJTB.Cns · JSON: typeстрокаСравниваетсяВид ограничения- Назначение
- P — PRIMARY KEY, U — UNIQUE, R — FOREIGN KEY, C — CHECK.
- При переносе:
- Из этого кода собирается SQL. Другой вид Holkas отклоняет с объяснением при формировании SQL. Остальные поля должны соответствовать выбранному виду.
ColumnsJTB.Cns · JSON: columnsстрока / nullСравниваетсяСвои колонки- Назначение
- Список через запятую в порядке позиций ключа, например RN,VERSION.
- При переносе:
- Порядок сохраняется в SQL и важен для сравнения. Каждое имя даёт ожидание Create JTB.Col, если такая команда есть; для нового JTB колонки уже созданы корнем. У CHECK SQL использует SearchCondition.
SearchConditionJTB.Cns · JSON: searchConditionстрока / nullСравниваетсяУсловие CHECK- Назначение
- Выражение без внешнего CHECK, например AMOUNT >= 0.
- При переносе:
- Исполняется для Type=C; для иных видов не подставляется. Пробелы и переводы строк вне литералов не считаются различием; текст в кавычках и строчные комментарии
--сохраняются.
RefSchemaJTB.Cns · JSON: refSchemaстрока / nullСравниваетсяСхема цели FK- Назначение
- Схема таблицы, на которую ссылается R.
- При переносе:
- Вместе с RefTable задаёт SQL-цель и ожидание Create/Update целевого JTB. Для P/U/C в создаваемом SQL не используется.
RefTableJTB.Cns · JSON: refTableстрока / nullСравниваетсяТаблица цели FK- Назначение
- Имя целевой таблицы отдельно от RefSchema.
- При переносе:
- Используется у R в REFERENCES. Приёмник должен иметь таблицу и подходящий ключ либо их команды в плане. Само поле не включает цель в выгрузку.
RefConstraintJTB.Cns · JSON: refConstraintстрока / nullСравниваетсяКлюч цели FK- Назначение
- Имя первичного или уникального ограничения цели, прочитанное из каталога Oracle.
- При переносе:
- Используется для ожидания Create JTB.Cns цели. В REFERENCES имя ключа не вставляется: Oracle определяет его по RefColumns. Ожидание Update ограничения этим правилом не задаётся.
RefColumnsJTB.Cns · JSON: refColumnsстрока / nullСравниваетсяКолонки цели FK- Назначение
- Перечень целевых колонок в порядке ключа.
- При переносе:
- Входит в REFERENCES и создаёт ожидания Create JTB.Col цели. Порядок должен соответствовать Columns; автоматической перестановки под другой ключ нет.
DeleteRuleJTB.Cns · JSON: deleteRuleстрока / nullСравниваетсяДействие FK при удалении строки- Назначение
- CASCADE — удалить дочерние строки, SET NULL — очистить ссылку, NO ACTION — обычное ограничение удаления.
- При переносе:
- Для Type=R CASCADE и SET NULL дописываются в SQL; остальные значения не добавляют ON DELETE. Это поведение прикладных DELETE после переноса, а не команда Holkas удалить таблицу.
EnabledJTB.Cns · JSON: enabledлогическоеСравниваетсяВключено ли ограничение- Назначение
- true — действует; false — отключено.
- При переносе:
- При создании false добавляет DISABLE; при изменении, в том числе только флажка, ограничение снимается и создаётся заново. Существующие данные могут помешать включению.
DeferrableJTB.Cns · JSON: deferrableлогическоеСравниваетсяМожно ли отложить проверку- Назначение
- true допускает отложенную проверку ограничения в транзакции.
- При переносе:
- Добавляет DEFERRABLE. При false Deferred не дописывается к SQL. Изменение — Update с пересозданием ограничения; не общая транзакция всего переноса.
DeferredJTB.Cns · JSON: deferredлогическоеСравниваетсяИзначально отложена ли проверка- Назначение
- При Deferrable=true задаёт INITIALLY DEFERRED вместо начальной немедленной проверки.
- При переносе:
- Используется только вместе с Deferrable. Сам false не отключает ограничение; за отключение отвечает Enabled. План сравнивает поле и при противоречивом ручном файле.
Индекс Oracle · JTB.Idx3 поля
IndexNameJTB.Idx · JSON: indexNameстрокаКлючИмя индекса- Назначение
- Имя самостоятельного индекса. Индексы P/U и LOB-сегментов исключены из списка чтения.
- При переносе:
- При смене имени Delete/Create; при прежнем имени Update с DROP/CREATE. Это обычное создание индекса, режим ONLINE или отдельные настройки хранения модель не переносит.
UniqueJTB.Idx · JSON: uniqueлогическоеСравниваетсяУникальный индекс- Назначение
- true добавляет UNIQUE к CREATE INDEX. Это не запись ограничения U.
- При переносе:
- При включении существующие дубли могут привести к отказу Oracle. Изменение флажка пересоздаёт индекс; подходящие данные заранее готовит владелец решения.
ColumnsJTB.Idx · JSON: columnsстрокаСравниваетсяКолонки и направления- Назначение
- Список в порядке индекса, например RN,STATUS DESC.
- При переносе:
- Порядок и DESC сохраняются в DDL. Для ребра суффикс DESC снимается, чтобы ждать колонку STATUS. Произвольные SQL-выражения текущая модель не переносит; не подменяйте имя колонки формулой.
Триггер Oracle · JTB.Trg6 полей
TriggerNameJTB.Trg · JSON: triggerNameстрокаКлючИмя триггера- Назначение
- Имя обработчика Oracle; собственной функции JFP у него нет.
- При переносе:
- Новое имя даёт Delete/Create. При прежнем имени отличия текста, состояния или невалидность приёмника дают Update JTB.Trg с CREATE OR REPLACE.
DescriptionJTB.Trg · JSON: descriptionстрокаСравниваетсяЗаголовок DDL- Назначение
- Часть ALL_TRIGGERS.DESCRIPTION: имя, BEFORE/AFTER, событие, таблица, FOR EACH ROW и другие условия. Это не комментарий.
- При переносе:
- Соединяется с Body после CREATE OR REPLACE TRIGGER. Переименование TriggerName само не переписывает этот текст. Сохраняйте согласованный заголовок из полного экспорта.
BodyJTB.Trg · JSON: bodyстрокаСравниваетсяТело триггера- Назначение
- PL/SQL-код, например begin :new.STATUS := 'NEW'; end;.
- При переносе:
- Записывается как обычный текст, без Base64. Вне литералов окончания строк CRLF/LF, хвостовые пробелы строк и пустые крайние строки не дают разницы, а текст литералов переносится точно; исполняемая логика начинает действовать при событиях таблицы. После переноса действует проверка компиляции Oracle.
EnabledJTB.Trg · JSON: enabledлогическоеСравниваетсяВключён ли триггер- Назначение
- false означает отключённый триггер.
- При переносе:
- Create/Update выполняют CREATE OR REPLACE, затем для false — ALTER TRIGGER DISABLE. Разница только Enabled тоже даёт полное обновление определения; это не отдельная команда состояния.
DependenciesJTB.Trg · JSON: dependenciesсписок / nullНе сравниваетсяЗависимости тела- Назначение
- Адреса физических объектов из каталога Oracle: TypeCode и Name. Например JPR + PARUS.P_REQUEST.
- При переносе:
- Сохраняются в файле и задают ожидание Create/Update целей при командах триггера. Только смена этого списка не создаёт Update. Null в старом файле означает отсутствие сохранённых сведений, а не доказательство отсутствия ссылок.
ValidJTB.Trg · JSON: не сохраняетсялогическоеСравниваетсяРезультат компиляции- Назначение
- Служебное состояние триггера, которое Holkas читает из приёмника; в описании из источника по умолчанию true.
- При переносе:
- В YAML/JSON не записывается. Если приёмник вернул false, план даёт Update даже при одинаковом тексте. После итоговой пересборки оставшийся INVALID показывается как неудача с ошибками; это не настройка, которую следует править в файле.
Право PostgreSQL или Oracle · TBP.Grant / JTB.Grant3 поля
GranteeTBP.Grant / JTB.Grant · JSON: granteeстрокаЧасть ключаПолучатель- Назначение
- Имя роли/пользователя или PUBLIC. Роли и членство в них не создаются.
- При переносе:
- Вместе с Privilege задаёт ключ. Смена получателя — отзыв у прежнего и выдача новому. Учитываются параметры соответствия ролей; PUBLIC — специальное обозначение всех, а не обычная роль.
PrivilegeTBP.Grant / JTB.Grant · JSON: privilegeстрокаЧасть ключаРазрешение- Назначение
- Например SELECT, INSERT, UPDATE, DELETE, REFERENCES; допустимый набор определяет СУБД.
- При переносе:
- Ключевое слово приводится к верхнему регистру. Смена — Delete/Create двух прав; Delete отзывает только названную привилегию у названного получателя.
WithGrantOptionTBP.Grant / JTB.Grant · JSON: withGrantOptionлогическое / nullСравниваетсяМожно ли передавать право- Назначение
- true — WITH GRANT OPTION; false и null приводятся к обычному праву без передачи.
- При переносе:
- Смена даёт Update того же гранта. PostgreSQL умеет снять GRANT OPTION отдельно; Oracle отзывает и выдаёт заново. Если получатель уже передал право дальше, Holkas отказывает опасному каскадному отзыву — разберите выданные права отдельно.
Команды плана
12 кодов: корень и пять видов частей для каждой СУБД. SetOrder у таблицы и её списков нет. Значки действий сохраняют подписи и английское обозначение из плана.
У корня, колонок, ограничений, индексов и триггеров строка плана показывает SQL — те же операторы и в том же порядке, что выполнит Holkas. У прав превью показывает намерение в общем виде.
PostgreSQL · TBP6 кодов
TBPТаблица PostgreSQL
Создаёт пустую таблицу, затем колонки добавляются отдельными командами. Create всегда назначает владельца, даже если он совпадает со Schema. Update меняет Comment и Owner. Delete по отсутствию таблицы в наборе не формируется.
Ключ: Схема.Таблица
TBP.ColКолонка · PostgreSQL
Добавляет новую колонку или меняет тип, допустимость NULL и умолчание существующей. Комментариев колонок в TBP-модели нет. Delete отсутствующей колонки не строится; изменение ключа не переносит старые значения.
Ключ: Схема.Таблица|ColumnName
TBP.CnsОграничение · PostgreSQL
Create добавляет ограничение; Update выполняет DROP и ADD внутри одной команды; Delete снимает отсутствующее. Это физический ключ или проверка СУБД, а не ограничение класса CNS. При Update нет отдельной ранней команды Delete для освобождения колонки.
Ключ: Схема.Таблица|ConstraintName
TBP.IdxИндекс · PostgreSQL
Create создаёт индекс; Update снимает и создаёт заново в одной команде; Delete снимает отсутствующий. Индексы, обслуживающие P/U, создаются их ограничениями и отдельно не дублируются.
Ключ: Схема.Таблица|IndexName
TBP.TrgТриггер · PostgreSQL
Create выполняет CREATE из TriggerValue и, если Enable не O, ставит режим. Update при прежнем тексте меняет Enable, при другом — DROP/CREATE с тем же восстановлением режима. Delete снимает привязку, функция JFP остаётся.
Ключ: Схема.Таблица|TriggerName
TBP.GrantПраво · PostgreSQL
Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает её. Создания роли или пользователя нет. Настройка пропуска лишних прав может убрать отзывы из плана; защита от каскадного отзыва остаётся.
Ключ: Схема.Таблица|Grantee:Privilege
Oracle · JTB6 кодов
JTBТаблица Oracle
Создаёт таблицу сразу со всеми колонками из источника и комментариями. Обычный Update меняет только комментарий самой таблицы; смена Persistence удаляет и создаёт таблицу заново, теряя строки и лишние прежние колонки. Delete по отсутствию таблицы в наборе не формируется.
Ключ: Схема.Таблица
JTB.ColКолонка · Oracle
Добавляет новую колонку или меняет тип (вместе с единицей длины BYTE или CHAR), допустимость NULL и умолчание существующей. Записывает и снимает Comment колонки; если изменился только он, MODIFY не выполняется; при создании/пересоздании JTB колонки входят в корень, своих команд не имеют. Delete отсутствующей колонки не строится; изменение ключа не переносит старые значения.
Ключ: Схема.Таблица|ColumnName
JTB.CnsОграничение · Oracle
Create добавляет ограничение; Update выполняет DROP и ADD внутри одной команды; Delete снимает отсутствующее. Это физический ключ или проверка СУБД, а не ограничение класса CNS. При Update нет отдельной ранней команды Delete для освобождения колонки.
Ключ: Схема.Таблица|ConstraintName
JTB.IdxИндекс · Oracle
Create создаёт индекс; Update снимает и создаёт заново в одной команде; Delete снимает отсутствующий. Индексы, обслуживающие P/U, создаются их ограничениями и отдельно не дублируются.
Ключ: Схема.Таблица|IndexName
JTB.TrgТриггер · Oracle
Create/Update выполняют CREATE OR REPLACE из Description + Body, затем при Enabled=false отключают триггер. Если триггер в приёмнике невалиден, план тоже показывает Update. Delete снимает триггер; отдельного обработчика JFP здесь нет.
Ключ: Схема.Таблица|TriggerName
JTB.GrantПраво · Oracle
Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает её. Создания роли или пользователя нет. Настройка пропуска лишних прав может убрать отзывы из плана; защита от каскадного отзыва остаётся.
Ключ: Схема.Таблица|Grantee:Privilege
Ограничения и что с ними делать
Переименование не переносит прежние строки
Если в источнике вместо legacy_note появилась note, обычный план создаёт note и сохраняет legacy_note приёмника. Значения из старой колонки в новую не копируются. Смена имени таблицы тоже означает другую таблицу, а не перенос её строк.
Для сохранения данных при переименовании подготовьте отдельное согласованное изменение схемы и данных. Не подменяйте его удалением старого поля из YAML: команды Delete колонки при обычном переносе нет.
Отсутствующая часть выбранной таблицы может удалиться
Колонка legacy_note без пары в источнике сохраняется, но индекс ix_legacy без пары получает Delete TBP.Idx/JTB.Idx. Отсутствующий триггер тоже может удалиться: последующие изменения строк больше не запустят его проверку.
Правило касается полного состава выбранной таблицы. Сохранить местный индекс или триггер можно снятием соответствующей команды с исполнения; для прав есть отдельный параметр пропуска лишних прав. Отсутствие целой таблицы в наборе не даёт Delete таблицы.
Существующие данные мешают изменению структуры
NOT NULL откажет на незаполненных строках, уникальный индекс — на дублях, FK — на ссылках без цели. Сужение типа или длины также может не пройти. PostgreSQL ALTER TYPE не получает от Holkas собственного USING для преобразования значений.
Подготовьте прикладные данные и выражение преобразования отдельно, затем стройте план требуемой структуры. Новый Default влияет на последующие записи, а не переписывает старые значения сам по себе. Команда Update не означает, что текущие строки допустимы для её SQL.
Индекс или ограничение остаётся и держит колонку
Holkas ставит перед изменениями колонок только те Delete ограничений, индексов и триггеров, которые уже появились в плане. Неизменившийся объект не снимается автоматически. Update ограничения или индекса содержит собственные DROP/CREATE внутри одной команды, а не отдельное раннее снятие.
Например, изменение типа колонки может быть отклонено из-за существующего внешнего ключа. Разберите конкретную зависимость и подготовьте снятие/восстановление отдельно. Не считайте два взаимных FK автоматическим циклом: у новых таблиц их создание идёт после таблиц и ключей, но обновление уже используемых ключей требует отдельного внимания.
PostgreSQL: FK к UNIQUE другой таблицы ждёт этот ключ
Каталог заполняет ConstraintRef только для PRIMARY KEY, поэтому план находит ключ цели по колонкам: FK child ждёт Create того PRIMARY KEY или UNIQUE target, чьи колонки совпадают со ссылкой. Порядок не зависит от того, какая таблица стоит в наборе первой, и одинаков для файлов, записанных любой версией.
Если ключ target отказал (например, дубли в приёмнике), FK пропускается с указанием причины, а сама таблица child создаётся. FK, опирающийся не на ограничение, а на отдельный уникальный индекс, этого ожидания не получает.
PostgreSQL: триггер и его функция переносятся раздельно
Выбор TBP несёт привязку триггера, но не JFP с его кодом и правами. Если функции нет ни в наборе, ни в приёмнике, план предупреждает о непокрытой зависимости; её можно добавить из источника, если источник это поддерживает. Для файла пакета нужен новый пакет с функцией.
Если функция уже есть, но старая, проверка наличия не обнаружит её устаревший код. Даже полностью совпавшая таблица не добавит команду функции. Поэтому изменённую функцию включайте отдельно. Аналогично последовательность из Default и таблицу цели FK нужно обеспечить в приёмнике или составе переноса.
Ссылки произвольного SQL внутри функции не дают полного графа. Функция на LANGUAGE sql ждёт таблицу и колонки из своего запроса, если они в том же наборе. Таблицу, которой нет в наборе, план не предлагает.
SQL-файл идёт в том же порядке, что и перенос в базу: триггер записан после функции, которую вызывает, а внешний ключ — после ключа таблицы, на которую ссылается, даже если эта таблица в наборе позже. Файл, выгруженный версией 0.1.35 или более ранней, мог содержать таблицу целиком, вместе с триггером, раньше функции, и psql останавливался на «function … does not exist»: выгрузите такой набор заново.
PostgreSQL: режим триггера при создании и замене определения
PostgreSQL хранит режим триггера отдельно от определения, и CREATE TRIGGER всегда создаёт обычный включённый триггер (O). Поэтому Holkas после создания, после DROP/CREATE при изменённом TriggerValue и в SQL-файле отдельно выполняет ALTER TABLE … DISABLE, ENABLE REPLICA или ENABLE ALWAYS TRIGGER. Отключённая в источнике проверка остаётся отключённой и в приёмнике.
Oracle: смена режима хранения пересоздаёт таблицу
Persistence=Transaction означает очистку строк при COMMIT, Session — сохранение до конца сеанса. Отличие режима существующего JTB вызывает DROP TABLE и CREATE с колонками из источника; ограничения, индексы, триггеры и права в плане создаются заново. Строки и лишняя прежняя колонка исчезают. Утверждение «лишние колонки сохраняются» относится к обычному обновлению без такого пересоздания.
Старый файл без Persistence считается Permanent: для временной таблицы выгрузите полное новое описание. Не снимайте предупреждение пересоздания как косметическое отличие. Если в приёмнике есть внешние FK, DROP без CASCADE может отказать; Holkas не удаляет чужие зависимости каскадом.
Oracle: DDL не откатывается вместе со всем переносом
DROP, CREATE, ALTER и COMMENT фиксируются средствами Oracle. Если Update JTB.Cns снял ограничение, а повторный ADD был отвергнут, снятие может сохраниться. То же важно для пересоздания таблицы.
После отказа сначала установите фактическое состояние и перестройте план. Не рассчитывайте, что режим общей транзакции вернёт Oracle DDL. Подробнее — правила применения.
Oracle: комментарий колонки сняли на источнике
У колонки CODE в приёмнике комментарий «Номер», а на источнике его сняли. План строит одну Update JTB.Col: она выполняет COMMENT ON COLUMN со значением '' без MODIFY колонки, и повторный план пуст. Если одновременно меняется тип или умолчание, та же команда сначала выполняет MODIFY, затем снимает комментарий.
Oracle хранит пустой комментарий как отсутствие комментария, поэтому Comment: "" в файле пакета или git сравнивается так же, как null, и не даёт повторного Update.
Oracle: новая колонка с комментарием и Update корня
Если одновременно добавить EXTRA с комментарием и поменять Comment таблицы, план содержит Update JTB и Create JTB.Col. Корень меняет только комментарий таблицы, а колонку EXTRA вместе с её комментарием добавляет своя команда. Оба изменения проходят одним планом.
Если снять галочку с Create JTB.Col, применится только комментарий таблицы. Колонка и её комментарий останутся разницей и появятся в следующем плане.
Oracle: форматирование и литералы в DEFAULT и CHECK
Oracle хранит DATA_DEFAULT и SEARCH_CONDITION так, как их набрали. Holkas сводит пробелы, отступы и переводы строк вне литералов к одному пробелу, поэтому DEFAULT 0 и то же значение с переносом строки считаются одинаковыми.
Текст в кавычках сохраняется точно: 'A B', многострочные литералы, q'[…]' и идентификаторы в двойных кавычках. Строчный комментарий -- в CHECK сохраняет свой перевод строки, поэтому остаток условия не попадает в комментарий.
Пакеты и снимки git, выгруженные версией 0.1.33 или более ранней, хранят такой текст со схлопнутыми пробелами: выгрузите их заново из исходной базы.
Oracle: байтовая длина на приёмнике с символьной семантикой
Длина строковой колонки Oracle мерится в байтах или в символах. Holkas записывает единицу явно: VARCHAR2(20 BYTE) источника создаётся на приёмнике как VARCHAR2(20 BYTE), даже если там NLS_LENGTH_SEMANTICS = CHAR. Это касается и sql-файла, который выполняется другим клиентом.
PostgreSQL: точность времени и файлы, снятые старой версией
Заданная точность timestamp и timestamptz — например, timestamp(0) или timestamptz(3) — хранится в поле DatetimePrecision, и план её сравнивает.
Пакеты и снимки git, выгруженные версией 0.1.33 или более ранней, точности не содержат и описывают колонку без модификатора: выгрузите их заново из исходной базы, иначе перенос из такого файла вернёт приёмнику точность по умолчанию.
PostgreSQL: сортировка колонок у таблиц, перенесённых версией 0.1.35 или более ранней
До 0.1.35 включительно явное правило сортировки колонки не читалось: например, code text COLLATE "C" переносилось как text и в приёмнике сортировалось по правилу базы, а повторный план оставался пустым. Индекс на такой колонке своего COLLATE в определении не несёт и тоже получал правило базы. Правило хранится в Collation и сравнивается; колонка без COLLATE переносится без него, а индекс с собственным COLLATE переносится своим определением.
Если таблицу переносили версией 0.1.35 или более ранней, новый план из базы-источника покажет TBP.Col Update; смену типа PostgreSQL выполняет вместе с перестройкой индексов колонки. Пакеты и снимки git, снятые версией 0.1.35 или более ранней, правила не содержат: выгрузите их заново из исходной базы. Правило с тем же именем должно быть в базе-приёмнике: системные C и POSIX есть всегда, правила ICU и локалей ОС зависят от сборки PostgreSQL и сервера. См. справку о правилах сортировки.
Регистрация PostgreSQL в конвертере Паруса
После применения TBP Holkas обновляет сведения о таблице и полях в справочнике sys.ppc$cnv$* через функцию Паруса. Это отличается от TABLELIST у CLS. Проход работает для схемы TARGET_SCHEMA; при отсутствии каталога или функции регистрации пропускается. В частности, в образах 23.04.2024–30.08.2024 нужной функции нет.
Регистрируются только объекты, у которых в этом прогоне до приёмника дошла хотя бы одна команда. Объект без изменений и объект, все команды которого сняты с исполнения или не прошли, справочник не трогает: прежняя запись остаётся как есть, а для несозданного объекта пустая запись не появляется. Повторный перенос без изменений поэтому не повторяет регистрацию, сорвавшуюся раньше; её восстанавливают средствами Паруса.
Повторная регистрация не восстанавливает все вычисленные при конвертации сведения о зависимостях и правах. Особенности timestamp зависят от релиза; сверяйтесь с проверенной совместимостью и границами регистрации в конвертере.
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Каждое связывает две команды и указывает, какая должна выполниться раньше.
Create TBP.Col · parus.udo_t_request|rnCreate TBP.Cns · parus.udo_t_request|pk_requestТаблица может уже существовать; пока колонки rn нет, её ключ создать нельзя. В Oracle у новой таблицы колонки уже входят в Create JTB, а у существующей добавление имеет отдельную JTB.Col.
Ниже 35 правил: свои части, прямые внешние потребители и общие проходы плана. Create/Update в одной строке означает проверенные ветви, а не обещание одинакового DDL.
Правила PostgreSQL12 правил
Create TBP→Create / Update TBP.Col, TBP.Cns, TBP.Idx, TBP.Trg, TBP.GrantКогда: Создаётся или меняется часть таблицы.
Сначала нужна таблица. Её обычного Update части не ждут.
Create SQP→Create / Update TBP.ColКогда: В Default распознано nextval(...).
Для голого имени проверяются варианты схемы таблицы и parus; неподтверждённые перечнем источника кандидаты лишь упорядочивают совпавшие команды. Квалифицированное имя и известная последовательность дают настоящую зависимость.
Create TBP.Col · свои колонки→Create / Update TBP.CnsКогда: Columns перечисляет имена.
Ограничение устанавливается после добавления своих колонок. Их Update этим правилом не ожидается.
Create TBP · цель→Create / Update TBP.CnsКогда: Заданы SchemaRef и TableRef.
Подготовить целевую таблицу внешнего ключа. Ожидания Update таблицы здесь нет.
Create TBP.Col · колонки цели→Create / Update TBP.CnsКогда: ColumnsRef перечисляет имена.
Подготовить колонки цели FK. Содержимое ConstraintValue само по себе не заменяет эти метаданные графа.
Create TBP.Cns · ключ цели→Create / Update TBP.Cns · FKКогда: ConstraintRef непуст и не указывает на эту же команду.
Каталог заполняет ConstraintRef только для PRIMARY KEY. FK на UNIQUE другой таблицы и FK из старых файлов, где поле пустое, ждут ключ по правилу «по колонкам».
Create TBP.Cns · PRIMARY KEY / UNIQUE цели с теми же колонками→Create / Update TBP.Cns · FKКогда: Type=f, ConstraintRef пуст, цель — другая таблица из набора, и у неё есть p или u с тем же набором колонок, что ColumnsRef (порядок и регистр не важны).
FK на UNIQUE другой таблицы встаёт после этого ключа, в каком бы порядке таблицы ни стояли в наборе, а отказ ключа пропускает FK как зависимый. Ключ, уже существующий в приёмнике, команды не имеет, и ждать нечего. FK на отдельный уникальный индекс без ограничения это ребро не получает.
Create TBP.Cns · все свои p/u→Create / Update TBP.Cns · самоссылка FKКогда: Type=f, цель — эта же таблица.
Самоссылка дополнительно ждёт все собственные первичные и уникальные ключи, кроме самой себя. FK к ключу другой таблицы ждёт его по правилу «по колонкам».
Create TBP.Col→Create / Update TBP.IdxКогда: Columns индекса перечисляет колонки.
Сначала добавить используемые колонки; их Update этим правилом не ожидается.
Create / Update JFP→Create / Update TBP.TrgКогда: Задан TriggerFunction.
Имя уже может содержать схему; иначе дополняется SchemaTriggerFunction. Функция обновляется с возможным пересозданием, поэтому триггер ждёт оба действия.
Delete TBP.Cns / TBP.Idx / TBP.Trg / TBP.Grant→Delete TBPКогда: Удаляется вложенная часть.
Ребро есть, но текущий перенос Delete TBP не формирует. Оно не добавляет удаление таблицы.
Delete TBP.Cns / TBP.Idx / TBP.Trg→Create / Update TBP.Col / TBP.Cns / TBP.Idx / TBP.TrgКогда: Удаления этих частей уже есть в плане этой таблицы.
Каждая изменяемая/создаваемая часть ждёт все такие удаления. Это не отдельная фаза снятия неизменившихся зависимостей и не ожидание внутреннего DROP команды Update.
Правила Oracle12 правил
Create JTB→Create / Update JTB.Col / JTB.Cns / JTB.Idx / JTB.Trg / JTB.GrantКогда: Создаётся или меняется часть.
У новой таблицы колонки включены в JTB, отдельных Create JTB.Col нет. Обычный Update корня части не ожидают.
Create JTB.Col · свои колонки→Create / Update JTB.CnsКогда: Columns ограничения перечисляет имена.
Подготовить добавляемые колонки существующей таблицы. Update колонок этим правилом не ожидается.
Create / Update JTB · цель→Create / Update JTB.CnsКогда: Заданы RefSchema и RefTable.
Учесть и создание, и пересоздание целевой таблицы; это не автоматическое снятие прежних FK, мешающих её DROP.
Create JTB.Col · колонки цели→Create / Update JTB.CnsКогда: RefColumns перечисляет имена.
Сначала добавить колонки целевой существующей таблицы. У нового JTB они уже входят в корневую команду.
Create JTB.Cns · ключ цели→Create / Update JTB.Cns · FKКогда: RefConstraint непуст; ссылка на саму команду исключена.
Подготовить первичный или уникальный ключ. Update ключа по этому правилу не ожидается.
Create JTB.Col→Create / Update JTB.IdxКогда: Columns индекса перечисляет имена.
При поиске имени из STATUS DESC берётся STATUS; направление индекса не становится частью адреса колонки.
Create / Update объекта из Dependencies→Create / Update JTB.TrgКогда: Список зависимостей тела сохранён при чтении каталога Oracle.
Порядок относится к команде триггера, а не созданию всей его таблицы. Собственная таблица как внешняя цель исключается.
Create / Update JTB.Col · цель→Create / Update JTB.TrgКогда: Dependencies триггера указывает другую JTB, и её колонки реально меняются в плане.
Ждать реальные команды колонок, а не требовать несуществующих команд совпавших частей.
Create / Update сохранённых зависимостей→Команда с прямой ссылкой на неизменённый объект OracleКогда: Описание цели из источника с Dependencies доступно; у неё нет корневой команды Create/Update.
Цепочка через совпавший объект разворачивается, и при JTB добавляются реальные команды его колонок. Это не полный разбор произвольного SQL.
Update JTB · смена Persistence→Create JTB.Cns / JTB.Idx / JTB.Trg / JTB.GrantКогда: Режим хранения строк существующей таблицы отличается.
DROP удаляет даже совпавшие части; план строит их Create от пустого состояния и ставит после пересоздания. Отдельных JTB.Col в этом пути нет.
Delete JTB.Cns / JTB.Idx / JTB.Trg / JTB.Grant→Delete JTBКогда: Удаляется вложенная часть.
Ребро есть, но обычного Delete JTB нет. Удаление таблицы внутри Update при смене Persistence — другой путь.
Delete JTB.Cns / JTB.Idx / JTB.Trg→Create / Update JTB.Col / JTB.Cns / JTB.Idx / JTB.TrgКогда: Такие удаления уже построены для этой таблицы.
Сначала снять уходящие части. Внутренний DROP команды Update ограничения/индекса не превращается в отдельную раннюю команду.
Непосредственные потребители таблицы9 правил
Create / Update TBP→Create / Update JVPКогда: В Dependencies PostgreSQL-представления сохранена ссылка на TBP; у старого файла — найден кандидат скана SQL.
Каталожная ссылка настоящая; кандидаты старого текстового скана только упорядочивают совпавшие команды.
Create / Update TBP.Col→Create / Update JVPКогда: Описание TBP в наборе доступно, и JVP ссылается на неё.
Дополнительно ожидаются колонки: пустой CREATE TABLE ещё не даёт нужных полей. Рёбра на них только для порядка, без ложных предупреждений о совпавших колонках.
Create / Update TBP→Create / Update JFP / JPPКогда: Распознан табличный тип в сигнатуре или declare-секции; у программы на LANGUAGE sql — также имя таблицы в любом месте тела.
Если источник подтверждает имя табличного типа, зависимость настоящая; иначе кандидат только упорядочивает. Имя из тела SQL-программы всегда только упорядочивает: таблица должна быть в том же наборе. SELECT в теле PL/pgSQL правилом не покрывается — PostgreSQL проверяет его при первом вызове.
Create / Update TBP.Col→Create / Update JFP / JPPКогда: Распознан табличный тип и описание TBP есть в наборе.
Ожидаются все колонки этой таблицы из набора с реальными командами; отсутствие отдельной команды совпавшей колонки допустимо.
Create / Update JTB→Create / Update зависимого объекта OracleКогда: Каталожные Dependencies зависимого называют таблицу.
Это рёбра к физической JTB, а не к CLS/CLO. Таблица сама не содержит общего списка Dependencies.
Create / Update JTB.Col→Create / Update зависимого объекта OracleКогда: В Dependencies есть JTB, и в плане реально создаются/меняются её колонки.
Зависимое определение должно дождаться изменений структуры. Для JTB.Trg это правило учтено отдельно выше.
Create / Update TBP или JTB→Create / Update CLSКогда: Включена регистрация/проверка событий таблицы, и в наборе есть соответствующая таблица схемы PARUS.
Класс ждёт физическую таблицу; без этих флагов TABLELIST может существовать без неё. Ребро только упорядочивает совпавшие команды.
Create / Update TBP.Trg или JTB.Trg→Create / Update CLSКогда: Те же флаги событий и соответствующая таблица в наборе.
Класс дополнительно ждёт все триггеры таблицы из источника. Это не перенос функции триггера вместе с CLS.
Create / Update TBP и её Col / Cns / Idx / Trg→Create / Update DAT, DAT.Row; DAT.RefКогда: Таблицы описания DAT есть в наборе TBP схемы parus.
Набор ждёт структуру и проверяющие части; права сюда не включены. Для JTB таких рёбер нет. Эти рёбра только упорядочивают совпавшие команды.
Скрипты автора2 правила
SCR Before→Охваченные TBP / JTB и их частиКогда: Приёмник исполняет скрипты, область включает таблицу либо весь перенос.
Скрипт выполняется до охваченных команд; это отдельный механизм, а не Default или тело триггера.
Охваченные TBP / JTB и их части→SCR AfterКогда: Та же область и время After.
Скрипт выполняется после команд; без охваченных команд исключается из плана. Порядок частей внутри объекта этим не заменяется.
Границы этих правил
Это каталог правил, а не число рёбер каждого плана. Рёбра удаляемых частей к Delete TBP/JTB не дают реального удаления таблицы. Рёбра для порядка действуют при совпадении с командой и не превращаются в предупреждение о недостающем объекте. Настоящая зависимость также участвует в выборе команд и пропуске зависимых после отказа.
Внутренние DROP/CREATE команды Update ограничения или индекса не разнесены на две фазы. Неизменившаяся зависимость может помешать ALTER COLUMN; наличие таблицы не гарантирует наличия её ключа. Колонки, ключи и SQL-фрагменты не дают полного графа произвольного серверного кода. Как разбирать недостающие зависимости →
Как таблица хранится в файлах
У таблицы один самостоятельный файл со всеми пятью списками. Ни отдельного файла для колонки, ни текста функции PostgreSQL внутри триггера нет. Учебные пути для двух платформ:
Git
YAMLTablePostgres/parus.udo_t_request.yamlДля Oracle — TableOracle/PARUS.UDO_T_REQUEST.yaml. Реквизиты и Columns, Constraints, Indexes, Triggers, Grants в одном файле.
S3
JSON в ZIPTablePostgres/parus.udo_t_request.jsonДля Oracle — TableOracle/PARUS.UDO_T_REQUEST.json. Имена свойств columns, constraints, indexes, triggers, grants начинаются с маленькой буквы.
Файл пакета
JSON в ZIPTablePostgres/parus.udo_t_request.jsonТакие же пути и содержимое описания таблицы; Oracle — в TableOracle. В manifest.json таблица указана один раз, части отдельно не перечисляются.
При чтении скачиваемого ZIP Holkas восстанавливает таблицу вместе с пятью вложенными списками.Для TBP и JTB запись и чтение JSON для S3 и для файла пакета, а также перекрёстное чтение ZIP проверены локально. Устройство таблиц в этих ZIP совпадает; это не общее обещание одинакового хранения любого типа Holkas. Для Git проверены настоящие запись и чтение YAML; отправка в репозиторий не выполнялась.
Пример строки оглавления: {"typeCode":"TBP","name":"parus.udo_t_request"}; для Oracle — {"typeCode":"JTB","name":"PARUS.UDO_T_REQUEST"}. Имя включает схему, но точка не создаёт подкаталога. Небезопасные символы имени файла кодируются: / как %2F, | как %7C; само имя объекта в манифесте остаётся обычным. Не переименовывайте файл отдельно от адреса объекта.
Одна колонка PostgreSQL в YAML и JSON
Сокращённые учебные фрагменты, не готовые файлы для импорта: из полного описания опущены другие реквизиты, колонки и все остальные списки.
Git — TablePostgres/parus.udo_t_request.yaml
Schema: parus
TableName: udo_t_request
Owner: parus
Columns:
- ColumnName: status
Type: varchar
Nullable: true
Default: "'NEW'::character varying"
CharMaxLength: 20
S3 и «Файл пакета» — TablePostgres/parus.udo_t_request.json
{
"schema": "parus",
"tableName": "udo_t_request",
"owner": "parus",
"columns": [{
"columnName": "status",
"type": "varchar",
"nullable": true,
"default": "'NEW'::character varying",
"charMaxLength": 20
}]
}
Сохраняйте полные Constraints, Indexes, Triggers и Grants. Их замена на [] действительно задаёт пустые списки и может удалить части приёмника; это не обозначение «остальное опущено».
Режим Oracle и зависимость тела триггера
Неполные учебные фрагменты одной JTB: они показывают формат, не предназначены для импорта. Текст Description — часть DDL, Body — обычная строка PL/SQL, Dependencies — адреса физических объектов. Иные реквизиты и части опущены.
Git — TableOracle/PARUS.UDO_T_REQUEST.yaml
Schema: PARUS
TableName: UDO_T_REQUEST
Persistence: Transaction
Triggers:
- TriggerName: T_REQUEST
Description: T_REQUEST BEFORE INSERT ON UDO_T_REQUEST FOR EACH ROW
Body: begin P_REQUEST; end;
Enabled: false
Dependencies:
- TypeCode: JPR
Name: PARUS.P_REQUEST
S3 и «Файл пакета» — TableOracle/PARUS.UDO_T_REQUEST.json
{
"schema": "PARUS",
"tableName": "UDO_T_REQUEST",
"persistence": 1,
"triggers": [{
"triggerName": "T_REQUEST",
"description": "T_REQUEST BEFORE INSERT ON UDO_T_REQUEST FOR EACH ROW",
"body": "begin P_REQUEST; end;",
"enabled": false,
"dependencies": [{"typeCode":"JPR","name":"PARUS.P_REQUEST"}]
}]
}
Здесь учебный триггер вызывает P_REQUEST без параметров; её определение переносится отдельно как JPR. Valid триггера не пишется; Holkas каждый раз заново читает его из приёмника. В JSON Persistence принимает 0/1/2, в YAML — Permanent/Transaction/Session.
Функция триггера PostgreSQL при её выборе сохраняется отдельно — например, FunctionPostgres/parus.f_request.yaml в Git или .json в ZIP. Сведения о манифесте — в справке о пакете; практические шаги — Git и файл пакета.
Основа: каталоги PostgreSQL/Oracle, модели, чтение, построение команд, исполнители и файловые транспорты Holkas 0.1.30; сохранённые зеркальные сценарии таблиц и результаты прежнего изучения КОР. Сверено 8 ноября 2026. UDO_T_REQUEST и схемы — учебные примеры. В этой работе локально проверены YAML, оба ZIP и планы; новый перенос в БД, зеркало и клиенты Паруса не запускались.