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

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

Составной тип

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

PostgreSQL

В командной строке: --object CTP:parus.udo_request_value · как задать состав в CLI

Составной тип PostgreSQL в доработке КОР Парус 8: все поля, права, порядок атрибутов, рёбра, команды и хранение в Git и ZIP.

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

PostgreSQL · именованная структура значения

Составной тип объединяет несколько полей в одно значение: например, код и сумму заявки. Holkas переносит его определение, владельца и права. Прикладные значения в таблицах вместе с ним не выгружаются.

АдресCTP + Схема.Имя типа
Поле внутри типаПо ItemName
Удаление целого типаНе формируется

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

Тип объекта в Holkas: CTP — самостоятельный составной тип PostgreSQL. Он описывает структуру значения, а не строки таблицы. Например, parus.udo_request_value с полями code varchar(20) и amount numeric(12,2) можно использовать в аргументе функции или как тип значения колонки. Это смысл составных типов PostgreSQL.

CTP не является доменом КОР или классом. Строчные типы, автоматически созданные для обычных таблиц и представлений, в списке CTP не предлагаются: соответствующая структура переносится с таблицей или представлением. Перечисления, SQL-домены и диапазоны PostgreSQL — другие виды типов. Oracle-варианта CTP и автоматического перевода в Oracle TYPE у Holkas нет.

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

Оба списка загружаются вместе с типом. CTP.Item и CTP.Grant — команды его частей; самостоятельных объектов с этими кодами в каталоге нет.

Выбор CTP не включает автоматически все использующие его функции и таблицы. Если нужно перенести функцию, принимающую такое значение, включите её отдельно. У CTP нет папки каталога Паруса: Schema — имя схемы БД, а CompositeTypePostgres/ — каталог файлов экспорта. Ни один из них не восстанавливает дерево папок КОР.

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

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

Все поля описания переноса: три реквизита типа, два списка, шесть свойств поля и три свойства права. Имена с заглавной буквы используются в Git YAML; рядом приведены имена JSON обоих ZIP.

Как читать обозначения и правила

Ключ определяет сопоставление. Сравнивается — разница учитывается при построении плана. По элементам — список разбирается на команды частей. Обнаруженное отличие не всегда может быть записано: ограничения указаны рядом с полем.

Сам тип · CTP5 полей
SchemaJSON: schema · CTPстрокаЧасть ключаСхема
Назначение
Пространство имён PostgreSQL, например parus. Это не папка Паруса и не роль владельца.
При переносе:
Вместе с CompositeTypeName задаёт адрес CTP. Другая схема означает другой объект: перенос создаст тип по новому адресу, старый не переместит и не удалит. Схема приёмника должна уже существовать.
CompositeTypeNameJSON: compositeTypeName · CTPстрокаЧасть ключаИмя типа
Назначение
Имя самостоятельного составного типа внутри схемы, например udo_request_value.
При переносе:
Узнаёт CTP по паре Schema + CompositeTypeName. Новое имя не вызывает RENAME: прежний тип и ссылки на него остаются.
OwnerJSON: owner · CTPстрокаСравниваетсяВладелец
Назначение
Роль PostgreSQL, владеющая типом. Может отличаться от Schema.
При переносе:
Изменение даёт Update CTP с ALTER TYPE OWNER TO. Create назначает владельца всегда, даже если Owner совпадает со Schema: подключение может идти под любой ролью, если она вправе назначить этого владельца. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется.
ItemsJSON: items · CTPсписокПо элементамПоля значения
Назначение
Упорядоченный список имён и типов полей составного значения.
При переносе:
CTP.Item сопоставляет записи по ItemName: добавляет новые, меняет тип существующих, удаляет лишние. [] удаляет все поля выбранного типа. Порядок, которого в базе не получить (перестановка прежних полей, вставка в середину), даёт отказ всего типа; см. ограничение порядка.
GrantsJSON: grants · CTPсписокПо элементамПрава на тип
Назначение
Список записей ACL — получатель, привилегия и передача права.
При переносе:
CTP.Grant сравнивает по паре Grantee + Privilege, без учёта порядка; меняет WithGrantOption отдельно. Лишние права существующего типа отзываются, если не включено их сохранение. Права по умолчанию — USAGE у PUBLIC и владельца — входят в список так же, как явные; [] означает, что USAGE нет даже у них. Доступ через членство в ролях список не описывает.
Поля значения · Items[] · CTP.Item6 полей
ItemNameJSON: itemName · CTP.ItemстрокаКлючИмя поля
Назначение
Имя атрибута составного значения, например code. Это не атрибут класса CLS.Attr.
При переносе:
Ключ CTP.Item внутри типа. Смена code на new_code даёт Delete старого и Create нового поля, без RENAME и без переноса прежнего значения. Новое поле добавляется в конец.
TypeItemJSON: typeItem · CTP.ItemстрокаСравниваетсяТип поля
Назначение
Системное имя pg_type.typname: int4, bpchar, varchar, numeric; _int4 обозначает массив int4[]. Однобайтовый системный тип пишется с кавычками: "char". Слово char без кавычек — обычный SQL char, Holkas приводит его к bpchar.
При переносе:
Вместе с размером задаёт ADD ATTRIBUTE или ALTER ATTRIBUTE SET DATA TYPE через CTP.Item. Например, varchar + LengthPrecision=20 даёт varchar(20). Словарь ограничен: произвольный пользовательский тип не станет переносимым от одного присутствия в файле. Неверное или пустое имя не является командой сохранить старый тип.
LengthPrecisionJSON: lengthPrecision · CTP.Itemцелое / nullСравниваетсяДлина строки или точность числа
Назначение
Для varchar/bpchar — предельное число символов; для numeric — общее число значащих цифр. Например, 12 в numeric(12,2).
При переносе:
Разница даёт Update CTP.Item. null убирает ограничение у varchar, bpchar и numeric; char без размера означает char(1), то же, что bpchar с длиной 1. У numeric с заданной точностью и без NumericScale получается numeric(12), с нулевым масштабом. Для int4, timestamp и прочих типов без этой настройки значение при записи не используется; точность времени хранит DatetimePrecision.
NumericScaleJSON: numericScale · CTP.Itemцелое / nullСравниваетсяМасштаб числа
Назначение
Для numeric — число цифр после запятой. Значение 2 вместе с LengthPrecision=12 означает numeric(12,2); 0 задаёт целое число.
При переносе:
Записывается через CTP.Item только при TypeItem=numeric и заданном LengthPrecision. Если точность отсутствует, получается numeric без обоих ограничений; для других типов поле не используется. null не означает «сохранить старый масштаб». С PostgreSQL 15 масштаб может быть отрицательным: -2 при numeric(12,-2) округляет до сотен.
DatetimePrecisionJSON: datetimePrecision · CTP.Itemцелое / nullСравниваетсяТочность времени
Назначение
Заданное число знаков дробных секунд у timestamp и timestamptz, например 3 в timestamptz(3); у массива timestamp(3)[] — точность элемента. Null — модификатора нет, точность по умолчанию.
При переносе:
Дописывается к типу поля; разница даёт Update CTP.Item через ALTER ATTRIBUTE SET DATA TYPE. Файлы, снятые до появления поля, его не содержат и означают «без модификатора».
CollationJSON: collation · CTP.Itemстрока / nullСравниваетсяПравило сортировки
Назначение
Явное правило сортировки текстового поля в виде схема.имя: например, pg_catalog.C для code text COLLATE "C". Null — правило типа по умолчанию, то есть сортировка базы, или тип без сортировки, как int4.
При переносе:
Дописывается к типу поля как COLLATE; разница даёт Update CTP.Item через ALTER ATTRIBUTE SET DATA TYPE, а null возвращает правило по умолчанию. Правило должно существовать в базе-приёмнике. Файлы, снятые до появления поля, его не содержат и означают «по умолчанию».
Права · Grants[] · CTP.Grant3 полей
GranteeJSON: grantee · CTP.GrantстрокаЧасть ключаПолучатель права
Назначение
Имя существующей роли либо PUBLIC — все роли базы.
При переносе:
Часть ключа CTP.Grant. Смена получателя отзывает прежнюю выдачу и создаёт новую. Роли не создаются из списка; для других имён настройте соответствие ролей. Используйте обычные строчные роли PostgreSQL; PUBLIC хранится заглавными буквами.
PrivilegeJSON: privilege · CTP.GrantстрокаЧасть ключаПривилегия
Назначение
Для составного типа — USAGE: разрешение использовать тип при создании объектов, которые на него ссылаются.
При переносе:
Вторая часть ключа CTP.Grant. Это не право SELECT на таблицу и не право исполнять функцию. Имя сохраняется заглавными буквами; произвольная привилегия не становится допустимой для TYPE только потому, что записана в файле.
WithGrantOptionJSON: withGrantOption · CTP.Grantлогическое / nullСравниваетсяПередача права
Назначение
true разрешает получателю выдавать это право другим ролям. null и false означают обычное право.
При переносе:
Разница даёт Update CTP.Grant: выдачу WITH GRANT OPTION либо снятие только возможности передачи. Само USAGE при снятии передачи сохраняется. false нормализуется в null и не выводится отдельным полем. Если право уже передано дальше, отзыв без CASCADE может быть отклонён.
Пустой список, пропуск поля и права по умолчанию

В обоих ZIP items и grants обязательны: пропуск или null отклоняется при загрузке, [] означает настоящий пустой список. При загрузке из Git неполное описание с null вместо списка может быть принято; оно не становится допустимым для построения плана. Сохраняйте оба списка явно.

Ручная запись numeric(12) без NumericScale равна numeric(12,0), а char без размера — bpchar с длиной 1: так тип читает каталог. После переноса повторный план пуст.

Каталог CTP читает права так, как их видит PostgreSQL: у типа без явных прав (null ACL) в Grants попадают USAGE у PUBLIC и у владельца. Поэтому [] — запрет использования для всех, а не «права по умолчанию»; о пакетах, снятых старой версией, — в разделе права нового типа.

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

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

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

CTP
CreateUpdate

Сам составной тип

Create создаёт пустой тип, затем отдельные CTP.Item добавляют поля. Корневая команда также назначает владельца — всегда, даже если он совпадает со Schema. Update меняет только владельца. Разница только в Items или Grants не требует Update CTP. Исключение — порядок полей, которого в базе не получить: тогда в плане появляется Update CTP с отказом, а поля и права типа ждут его и не выполняются; см. ограничение порядка.

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

CTP.Item
CreateUpdateDelete

Поле составного значения

Create добавляет поле в конец; Update меняет его тип, длину, числовую точность или точность времени; Delete удаляет поле, отсутствующее в списке источника. При применении используется ALTER TYPE ADD / ALTER / DROP ATTRIBUTE, без автоматического RENAME, CASCADE или преобразования USING.

Ключ: Схема.Имя типа|Имя поля

CTP.Grant
CreateUpdateDelete

Право использовать тип

Create выдаёт USAGE, Delete отзывает выдачу целиком. Update меняет только передачу права: true выдаёт WITH GRANT OPTION, null снимает GRANT OPTION, сохраняя USAGE. Отзыв не выполняется каскадом. Владелец и эффективный доступ через роли — отдельные свойства.

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

Delete CTP и SetOrder CTP.Item не формируются. Отсутствие целого типа в наборе не даёт DROP TYPE, но лишние поля внутри выбранного типа могут удаляться. SQL-файл описывает создание типа со всеми полями и правами; это не набор ALTER для существующего приёмника.

Пример: увеличить длину кода и снять передачу права

В приёмнике code varchar(20), amount numeric(12,2); reader имеет USAGE с передачей. В источнике code стал varchar(40), остальные поля прежние; reader сохранил USAGE, но без передачи.

  1. Update CTP.Item · parus.udo_request_value|code меняет тип поля на varchar(40).
  2. Update CTP.Grant · parus.udo_request_value|reader:USAGE снимает только возможность передавать право.

Update CTP не нужен: владелец не изменился. Если включено сохранение лишних прав приёмника, вторая команда не появляется.

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

Лишнее поле удаляется; переименование не сохраняет значение

Если в приёмнике есть legacy_note, а в Items источника его нет, план содержит Delete CTP.Item. У таблицы лишняя колонка обычно сохраняется; у CTP правило другое. При успешном удалении поле исчезает из структуры. Не сокращайте реальный список Items до полей из учебного примера.

Смена имени code на new_code — удаление и добавление, не переименование с сохранением данных. Новый адрес самого типа, напротив, создаёт другой CTP и оставляет старый. Когда нужно сохранить значения или перестроить их смысл, подготовьте отдельное изменение структуры и данных с учётом потребителей.

Другой порядок полей в БД — отказ всего типа

Порядок Items — порядок атрибутов в БД. По нему раскладываются позиционные значения: ROW(...), текстовый литерал '(A1,100)', SELECT ... INTO, RETURN QUERY. PostgreSQL не умеет переставлять поля существующего типа: новое поле встаёт в конец. Поэтому Holkas сравнивает порядок, который получится после переноса, с порядком источника.

Например, в приёмнике (code, amount), а в источнике (amount, code). Или в приёмнике (a, c), а в источнике поле b вставлено в середину: (a, b, c). В плане появится Update CTP с предупреждением, где названы оба порядка. При применении в БД эта команда отказывает до любых изменений. Поля, права и владелец типа не меняются, а функции и процедуры набора, которые ждут этот тип, пропускаются. Повторный план покажет тот же отказ.

Без отказа обходятся новые поля в конце, удаление полей и смена типа поля на месте. Новый тип создаётся сразу в порядке источника. Приёмник Git записывает порядок источника как есть, а перенос такого файла в БД отказывает так же.

Что делать: если порядок важен программе, переставьте поля в приёмнике отдельной миграцией типа и его потребителей. Если не важен — приведите источник к порядку приёмника. Holkas сам не удаляет и не пересоздаёт поля ради порядка: это теряет значения и ломает зависимые объекты.

Поддерживаемые типы и размеры полей

При записи Holkas принимает строковые char/bpchar и varchar, numeric с точностью и масштабом. Также поддержаны bool, bytea, date, float4, float8, int2, int4, int8, oid, text, timestamp, timestamptz и их массивы: например, _int4 записывается как int4[]. Экспорт обычного SQL char(n) использует системное имя bpchar.

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

Массивы varchar/numeric с модификатором элемента этим путём не записываются: _varchar вызывает отказ, а не молчаливый varchar[]. Пользовательский тип, домен, enum, uuid, jsonb и прочие имена вне словаря также не поддержаны. То, что их удалось извлечь из БД, ещё не означает возможность применить CTP.Item. Для такой структуры подготовьте отдельный SQL-маршрут или согласованное изменение определения.

Уменьшение длины либо смена типа использует ALTER ATTRIBUTE SET DATA TYPE без USING и CASCADE. PostgreSQL может запретить изменение из-за сохранённых значений, зависимых объектов или типизированной таблицы. План не является обещанием произвольной конвертации. Возможности СУБД — в справке ALTER TYPE.

Точность времени и файлы, снятые старой версией

Точность поля timestamp(0) или timestamptz(3) хранится в DatetimePrecision и сравнивается, в том числе у массива timestamp(3)[].

Пакеты и снимки git, выгруженные версией 0.1.33 или более ранней, точности не содержат: выгрузите их заново из исходной базы.

Сортировка полей и файлы, снятые старой версией

Явное правило сортировки поля — например, code text COLLATE "C" — хранится в Collation и сравнивается; поле без COLLATE переносится без него.

Пакеты и снимки git, выгруженные версией 0.1.34 или более ранней, правила не содержат: выгрузите их заново из исходной базы. Правило с тем же именем должно быть в базе-приёмнике: системные C и POSIX есть всегда, правила ICU и локалей ОС зависят от сборки PostgreSQL и сервера. См. справку о правилах сортировки.

Отрицательный масштаб numeric на PostgreSQL 15+

Начиная с PostgreSQL 15 допустим отрицательный масштаб: например, numeric(12,-2) округляет до сотен. Масштаб читается со знаком и сравнивается как есть; numeric(12,-2) переносится и меняется командой CTP.Item Update.

В пакете или снимке git, выгруженном версией 0.1.34 или более ранней, у такого поля записано 2046: выгрузите его заново из исходной базы. На PostgreSQL 14 отрицательный масштаб не поддерживает сама СУБД. См. numeric PostgreSQL 15.

Права нового типа и пакеты, снятые старой версией

PostgreSQL выдаёт PUBLIC право USAGE при создании типа. План нового типа считает права от этого умолчания: если источник закрыл тип от PUBLIC, в плане первого же переноса есть Delete CTP.Grant для PUBLIC:USAGE, и тип закрыт сразу после применения. SQL-файл того же типа содержит REVOKE. Если default privileges приёмника выдают или отзывают права у новых типов, Create CTP приводит права нового типа к умолчанию PostgreSQL, а дальше их меняют команды CTP.Grant из плана.

Пакеты и снимки Git, снятые версией 0.1.34 или более ранней, у типов без явных прав хранят [] — это значит «USAGE нет ни у кого», и план предложит отозвать USAGE у PUBLIC и владельца. Прежде чем переносить такой файл, выгрузите его заново из исходной базы. Правила умолчаний — в справке PostgreSQL о правах.

Владелец, полномочия и переданные права

Схема и роли должны существовать. Смена Owner требует прав на тип и возможности назначить новую роль владельцем. Схема не задаёт владельца автоматически: PostgreSQL отдаёт новый тип роли подключения, поэтому Create и SQL-файл всегда выполняют ALTER TYPE … OWNER TO. Подключение может идти под отдельной ролью, если она может стать владельцем (SET ROLE) и у владельца есть CREATE в схеме — иначе план назовёт препятствие. При других именах настройте соответствие ролей и владельцев.

Если reader уже передал USAGE другой роли, отзыв выдачи или возможности передачи может быть отклонён без CASCADE. Разберите следующие выдачи отдельно или сохраните нужное право в составе источника. Удаление поля и отзыв права — разные ограничения: доступ к типу не отменяет зависимости структуры.

Отказ поля может оставить уже созданную часть типа

В обычном режиме корень и поля исполняются отдельными командами. Если Create CTP и добавление code прошли, а добавление amount отклонено, уже выполненные команды могут сохраниться: в приёмнике останется неполная структура. Отказ создания корня блокирует зависимые добавления и выдачи прав.

В режиме одной транзакции отказ останавливает перенос с откатом его изменений. Не смешивайте эти режимы. Ни один из них не добавляет поддержку отсутствующего в словаре типа и не разрешает CASCADE автоматически.

Рёбра команд

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

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

1 · Подготовить структуруСоздать тип и добавить поляCreate CTP + Create CTP.Item
→
2 · Подготовить потребителяСоздать функцию с этим типомCreate JFP
Учебный пример: функция получает udo_request_value и обращается к amount. Она ждёт нужные команды полей, даже если во входном наборе стояла первой.

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

14 правил: собственные части, непосредственные потребители PostgreSQL и скрипты. Это число правил справки, а не обязательное количество рёбер каждого плана.

Читайте слева направо: раньше → позже. Правила только для порядка не требуют добавлять отсутствующую команду в набор.

Сам тип и его части5 правил
Create CTP→Create / Update CTP.Item

Когда: Добавляется или меняется поле этого типа.

Сначала должен существовать сам тип; ожидания Update CTP здесь нет.

Update CTP→Все команды CTP.Item / CTP.Grant

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

Update CTP несёт отказ. Поля и права ждут его и при отказе пропускаются, поэтому тип не меняется наполовину. См. ограничение порядка.

Create CTP→Create / Update CTP.Grant

Когда: Выдаётся право или меняется возможность его передачи.

Сначала создать тип. Отдельного ожидания Update владельца CTP это правило не добавляет.

Delete CTP.Item→Delete CTP
Нет команды удаления корня

Когда: У удаляемого поля есть ребро к удалению корня.

Delete CTP текущий план не создаёт: это не действующий способ удалить весь тип.

Delete CTP.Grant→Delete CTP
Нет команды удаления корня

Когда: У отзыва права есть ребро к удалению корня.

Команды Delete CTP нет; правило не превращает отзыв права в удаление типа.

Функции, процедуры и представления8 правил
Create / Update CTP→Create / Update JFP
Зависит от подтверждения источником

Когда: Тип найден в тексте функции: в объявлении переменной, сигнатуре либо RETURNS любой перегрузки.

Если источник подтверждает CTP, отсутствие типа проверяется как настоящая зависимость, а отказ типа при применении пропускает функцию; иначе это кандидат только для порядка.

Create / Update CTP.Item→Create / Update JFP
Только порядок

Когда: Та же ссылка JFP; описание CTP есть в наборе.

Для каждого поля Items источника добавляется ожидание создания/изменения поля, чтобы функция не попала между пустым типом и его наполнением.

Create / Update CTP→Create / Update JPP
Зависит от подтверждения источником

Когда: Тип найден в тексте процедуры: в поддержанных объявлениях или сигнатуре любой перегрузки.

Подтверждённый источником тип — настоящая зависимость, прочие кандидаты лишь упорядочивают совпавшие команды.

Create / Update CTP.Item→Create / Update JPP
Только порядок

Когда: Та же ссылка JPP и CTP есть в наборе.

Дождаться создания/изменения каждого поля типа из источника. Удаляемые поля это правило не ожидает.

Create / Update CTP→Create / Update JVP

Когда: В Dependencies представления каталог источника указал этот CTP.

Это настоящая зависимость: тип должен существовать до создания или изменения представления.

Create / Update CTP.Item→Create / Update JVP
Только порядок

Когда: Та же каталоговая ссылка JVP и CTP есть в наборе.

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

Create / Update CTP→Create / Update JVP
Только порядок

Когда: У старого файла JVP нет Dependencies, а скан текста нашёл подходящее имя.

Запасной кандидат: упорядочивает совпадение, но сам по себе не сообщает о недостающем типе. Пустой Dependencies=[] не включает запасной скан.

Create / Update CTP.Item→Create / Update JVP
Только порядок

Когда: То же запасное имя JVP и CTP есть в наборе.

Дополнительное ожидание создания/изменения каждого поля из источника; отсутствие команды поля допустимо.

Скрипты до и после2 правил
SCR Before→Команды CTP / CTP.Item / CTP.Grant

Когда: Исполняемый скрипт до переноса привязан к этому CTP либо ко всему переносу.

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

Команды CTP / CTP.Item / CTP.Grant→SCR After

Когда: Исполняемый скрипт после переноса привязан к этому CTP либо ко всему переносу.

Скрипт ждёт все команды выбранного типа, в том числе удаления полей и отзывы прав.

Границы рёбер и удаления полей

Ребро к Create существующего типа не означает, что его создание должно снова попасть в план. Подтверждённый источником тип проверяется на наличие в приёмнике; недостающий можно включить в перенос. См. недостающие зависимости.

В текстах JFP/JPP Holkas проверяет поддержанные объявления и заголовок каждой перегрузки, а не произвольные SQL-ссылки во всём теле. Сам CTP не сохраняет список Dependencies и не строит порядок между пользовательскими типами полей: их применение не поддержано.

Дополнительные рёбра потребителей ждут Create/Update полей источника; они не ставят Delete CTP.Item после изменения всех прежних потребителей. Например, удаление amount не гарантирует предварительную переделку старой функции, читающей amount. Holkas не добавляет CASCADE и не обходит запреты PostgreSQL.

Внутри списка Holkas строит удаления с конца текущего списка, затем изменения, затем добавления. Это исходная очередность, а не отдельные рёбра каждой пары. Порядок, которого так не получить, план не применяет, а отказывает: см. ограничение порядка.

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

Ищите CompositeTypePostgres/. Для учебного адреса parus.udo_request_value реквизиты, Items и Grants сохраняются вместе. Отдельных файлов Item или Grant нет.

Git

YAML
CompositeTypePostgres/parus.udo_request_value.yaml

Schema, CompositeTypeName, Owner, вложенные Items и Grants. Имена полей с заглавной буквы.

Holkas сохраняет описание в YAML и восстанавливает тот же тип со списками. Сведения о репозитории находятся в .holkas.

S3

JSON в ZIP
CompositeTypePostgres/parus.udo_request_value.json

Реквизиты, items и grants внутри одного JSON, с именами полей с маленькой буквы.

Holkas создаёт ZIP в S3, берёт состав из manifest.json и загружает JSON указанного типа.

Файл пакета

JSON в ZIP
CompositeTypePostgres/parus.udo_request_value.json

Скачиваемый ZIP включает свой manifest.json и такой же JSON типа со всеми полями и правами.

Выгрузка и загрузка файла пакета проверены отдельно; для CTP ZIP одного способа также загружается другим.

В manifest.json объект указан один раз: {"typeCode":"CTP","name":"parus.udo_request_value"}. СУБД и остальные метаданные описаны в справке о пакете. Небезопасные символы имени кодируются в пути: / становится %2F. Имя внутри описания от этого не меняется; не переименовывайте файл отдельно от адреса.

Полное учебное описание: YAML и JSON

Ниже — результат реальной выгрузки, загруженный обратно. Это определение структуры, а не прикладные значения. В вашей базе должны быть подготовлены схема parus, роли и полномочия. Ограничения начальных прав и порядка полей действуют и для этого описания.

Git — CompositeTypePostgres/parus.udo_request_value.yaml

Schema: parus
CompositeTypeName: udo_request_value
Owner: parus
Items:
- ItemName: code
  TypeItem: varchar
  LengthPrecision: 20
- ItemName: amount
  TypeItem: numeric
  LengthPrecision: 12
  NumericScale: 2
Grants:
- Grantee: reader
  Privilege: USAGE
  WithGrantOption: true

S3 и «Файл пакета» — CompositeTypePostgres/parus.udo_request_value.json

{
  "schema": "parus",
  "compositeTypeName": "udo_request_value",
  "owner": "parus",
  "items": [
    {
      "itemName": "code",
      "typeItem": "varchar",
      "lengthPrecision": 20
    },
    {
      "itemName": "amount",
      "typeItem": "numeric",
      "lengthPrecision": 12,
      "numericScale": 2
    }
  ],
  "grants": [
    {
      "grantee": "reader",
      "privilege": "USAGE",
      "withGrantOption": true
    }
  ]
}

При выгрузке null-поля опускаются; нули и пустые списки сохраняются. Например, NumericScale: 0 останется в файле, а отсутствие масштаба при заданной точности означает numeric(12), без дробной части. WithGrantOption: false преобразуется в null и опускается. Оба списка сохраняйте явно; Items: [] может удалить все поля существующего типа.

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

Основа: модель, каталог PostgreSQL, построители команд, исполнители и файловые адаптеры Holkas 0.1.30; смысл SQL сверён с документацией PostgreSQL 14, граница отрицательного numeric — с PostgreSQL 15. Проверено 9 ноября 2026. Имена и схемы учебные. Выполнены локальные пробы плана, генератора SQL и хранения, без нового переноса в БД и без проверки клиентов Паруса.