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

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

Таблица

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

PostgreSQL

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

Oracle

В командной строке: --object TBP:parus.udo_t_request или --object JTB:PARUS.UDO_T_REQUEST · как задать состав в CLI

Физические таблицы доработки КОР Парус 8: все поля PostgreSQL и Oracle, колонки, ключи, индексы, триггеры, права и правила переноса.

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

Структура базы · 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.

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

Это пять настоящих вложенных списков; реквизиты самой таблицы находятся в корне. Для Oracle — реквизиты, колонки, ограничения, индексы, триггеры. У частей свои команды, но отдельных выбираемых объектов или файлов для каждой колонки нет.

Выбор таблицы загружает все её переносимые части. Функция триггера PostgreSQL не вложена в таблицу: включайте JFP отдельно, даже если функция уже есть, но её код изменился. Целевые таблицы FK, последовательности умолчаний, классы и представления также выбираются отдельно. Связи между командами помогают с порядком, а не расширяют выгрузку до всей базы автоматически.

Создание различается. В PostgreSQL Create TBP создаёт пустую оболочку, затем идут Create TBP.Col. Oracle не создаёт таблицу без колонок: Create JTB включает сразу весь список Columns. Ограничения, индексы, триггеры и права в обоих случаях создаются отдельными командами.

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

75 полей · 11 групп

Поля таблицы и её частей для двух СУБД. Общие поля права показаны один раз. Имена с большой буквы соответствуют Git YAML, JSON начинается с маленькой. Служебные Owner Oracle и Valid отмечены отдельно; это не дополнительные настройки файла.

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

Ключ задаёт сопоставление таблицы или части; «Сравнивается» означает обнаруживаемую разницу, а не гарантию допустимости 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 отказывает опасному каскадному отзыву — разберите выданные права отдельно.
Пустые значения, полные списки и порядок колонок

Все пять списков должны присутствовать в полном файле. При чтении JSON из обоих ZIP пропуск или null вместо Columns, Constraints, Indexes, Triggers, Grants отклоняется. Git YAML при пропуске может прочитать null — это не поддержанный способ частичного обновления. Nullable Dependencies у триггера Oracle — другое поле, оно может отсутствовать.

[] у колонок обычной существующей таблицы не означает их удаление. [] у ограничений, индексов, триггеров и прав может дать удаления их элементов. При пересоздании Oracle список Columns задаёт новую таблицу целиком: прежняя лишняя колонка исчезнет вместе со строками. Для новой Oracle-таблицы пустой Columns не даёт допустимого CREATE TABLE.

Перестановка объектов в списках не переименовывает части и не меняет физические позиции колонок. Новая колонка существующей таблицы добавляется в конец. В строках сравнение приравнивает null к пустой строке и окончания CRLF к LF; числа null/0 и логические false/true различаются. Возможность прочитать пустое значение не доказывает допустимость полученного SQL.

При записи null опускается, а false, 0 и пустые списки сохраняются. WithGrantOption=false нормализуется в null; это обычное право без передачи. У Oracle Persistence=0 сохраняется и означает Permanent.

Какие типы колонок PostgreSQL Holkas сейчас умеет записывать

Поддержаны char/bpchar, varchar, numeric с размерами; bool, bytea, date, float4, float8, int2, int4, int8, oid, text, timestamp, timestamptz без модификаторов; у timestamp и timestamptz сохраняется заданная точность дробных секунд (поле DatetimePrecision). Одномерные массивы поддержаны только для последней группы: например _int4 записывается как int4[], а _timestamp с точностью 3 — как timestamp(3)[]. Для numeric[] или varchar[] с размером такого пути нет.

Слово char без кавычек — обычный SQL char: Holkas приводит его к bpchar, без длины — к длине 1. Однобайтовый системный тип пишется с кавычками, "char", и переносится собой; bpchar без длины — строка без ограничения. Пакет или снимок git, снятый версией 0.1.34 или более ранней, записал оба как char(1): выгрузите его заново.

Holkas может прочитать из базы больше типов, чем умеет записать. Например, jsonb и пользовательский составной тип в колонке вызывают отказ при формировании SQL; добавление CTP в набор само это не исправляет.

Что не входит в эти модели

Прикладные строки, папки каталогов Паруса, организация и версия записи здесь отсутствуют. Schema — пространство имён СУБД, а TablePostgres/TableOracle — каталоги файлов, не папки приёмника. Ни поиск папки по имени, ни восстановление полного пути к таблице не применяются.

Это перенос перечисленных свойств, а не полный снимок всех параметров CREATE TABLE: табличные пространства, секционирование, политики защиты строк, identity/generated-выражения и параметры хранения отдельными полями не представлены. У TBP также нет комментариев колонок и признака временной/UNLOGGED-таблицы. Каталог TBP читает обычный relkind=r, а не родительскую секционированную таблицу relkind=p.

У Oracle системно именованные ограничения исключены целиком; обычный NOT NULL описывает Nullable. Отдельный индекс первичного/уникального ключа не дублируется; LOB-индексы также пропускаются. Функциональные индексы Oracle не представлены выражениями, поэтому такой индекс нельзя считать полностью переносимым по одному списку Columns.

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

12 кодов: корень и пять видов частей для каждой СУБД. SetOrder у таблицы и её списков нет. Значки действий сохраняют подписи и английское обозначение из плана.

У корня, колонок, ограничений, индексов и триггеров строка плана показывает SQL — те же операторы и в том же порядке, что выполнит Holkas. У прав превью показывает намерение в общем виде.

PostgreSQL · TBP6 кодов
TBP
CreateUpdate

Таблица PostgreSQL

Создаёт пустую таблицу, затем колонки добавляются отдельными командами. Create всегда назначает владельца, даже если он совпадает со Schema. Update меняет Comment и Owner. Delete по отсутствию таблицы в наборе не формируется.

Ключ: Схема.Таблица

TBP.Col
CreateUpdate

Колонка · PostgreSQL

Добавляет новую колонку или меняет тип, допустимость NULL и умолчание существующей. Комментариев колонок в TBP-модели нет. Delete отсутствующей колонки не строится; изменение ключа не переносит старые значения.

Ключ: Схема.Таблица|ColumnName

TBP.Cns
CreateUpdateDelete

Ограничение · PostgreSQL

Create добавляет ограничение; Update выполняет DROP и ADD внутри одной команды; Delete снимает отсутствующее. Это физический ключ или проверка СУБД, а не ограничение класса CNS. При Update нет отдельной ранней команды Delete для освобождения колонки.

Ключ: Схема.Таблица|ConstraintName

TBP.Idx
CreateUpdateDelete

Индекс · PostgreSQL

Create создаёт индекс; Update снимает и создаёт заново в одной команде; Delete снимает отсутствующий. Индексы, обслуживающие P/U, создаются их ограничениями и отдельно не дублируются.

Ключ: Схема.Таблица|IndexName

TBP.Trg
CreateUpdateDelete

Триггер · PostgreSQL

Create выполняет CREATE из TriggerValue и, если Enable не O, ставит режим. Update при прежнем тексте меняет Enable, при другом — DROP/CREATE с тем же восстановлением режима. Delete снимает привязку, функция JFP остаётся.

Ключ: Схема.Таблица|TriggerName

TBP.Grant
CreateUpdateDelete

Право · PostgreSQL

Create выдаёт привилегию, Update меняет GRANT OPTION, Delete отзывает её. Создания роли или пользователя нет. Настройка пропуска лишних прав может убрать отзывы из плана; защита от каскадного отзыва остаётся.

Ключ: Схема.Таблица|Grantee:Privilege

Oracle · JTB6 кодов
JTB
CreateUpdate

Таблица Oracle

Создаёт таблицу сразу со всеми колонками из источника и комментариями. Обычный Update меняет только комментарий самой таблицы; смена Persistence удаляет и создаёт таблицу заново, теряя строки и лишние прежние колонки. Delete по отсутствию таблицы в наборе не формируется.

Ключ: Схема.Таблица

JTB.Col
CreateUpdate

Колонка · Oracle

Добавляет новую колонку или меняет тип (вместе с единицей длины BYTE или CHAR), допустимость NULL и умолчание существующей. Записывает и снимает Comment колонки; если изменился только он, MODIFY не выполняется; при создании/пересоздании JTB колонки входят в корень, своих команд не имеют. Delete отсутствующей колонки не строится; изменение ключа не переносит старые значения.

Ключ: Схема.Таблица|ColumnName

JTB.Cns
CreateUpdateDelete

Ограничение · Oracle

Create добавляет ограничение; Update выполняет DROP и ADD внутри одной команды; Delete снимает отсутствующее. Это физический ключ или проверка СУБД, а не ограничение класса CNS. При Update нет отдельной ранней команды Delete для освобождения колонки.

Ключ: Схема.Таблица|ConstraintName

JTB.Idx
CreateUpdateDelete

Индекс · Oracle

Create создаёт индекс; Update снимает и создаёт заново в одной команде; Delete снимает отсутствующий. Индексы, обслуживающие P/U, создаются их ограничениями и отдельно не дублируются.

Ключ: Схема.Таблица|IndexName

JTB.Trg
CreateUpdateDelete

Триггер · Oracle

Create/Update выполняют CREATE OR REPLACE из Description + Body, затем при Enabled=false отключают триггер. Если триггер в приёмнике невалиден, план тоже показывает Update. Delete снимает триггер; отдельного обработчика JFP здесь нет.

Ключ: Схема.Таблица|TriggerName

JTB.Grant
CreateUpdateDelete

Право · 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|rn
→
ЗатемСоздать первичный ключ по номеруCreate 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

YAML
TablePostgres/parus.udo_t_request.yaml

Для Oracle — TableOracle/PARUS.UDO_T_REQUEST.yaml. Реквизиты и Columns, Constraints, Indexes, Triggers, Grants в одном файле.

Holkas восстанавливает описание таблицы из YAML. В корне репозитория — .holkas со сведениями о нём.

S3

JSON в ZIP
TablePostgres/parus.udo_t_request.json

Для Oracle — TableOracle/PARUS.UDO_T_REQUEST.json. Имена свойств columns, constraints, indexes, triggers, grants начинаются с маленькой буквы.

Holkas берёт состав из manifest.json и читает соответствующий файл. Архив хранится в S3.

Файл пакета

JSON в ZIP
TablePostgres/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 и планы; новый перенос в БД, зеркало и клиенты Паруса не запускались.