PostgreSQL · именованная структура значения
Составной тип объединяет несколько полей в одно значение: например, код и сумму заявки. Holkas переносит его определение, владельца и права. Прикладные значения в таблицах вместе с ним не выгружаются.
CTP + Схема.Имя типаЧто это за объект
Тип объекта в 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 не включает автоматически все использующие его функции и таблицы. Если нужно перенести функцию, принимающую такое значение, включите её отдельно. У CTP нет папки каталога Паруса: Schema — имя схемы БД, а CompositeTypePostgres/ — каталог файлов экспорта. Ни один из них не восстанавливает дерево папок КОР.
Справочник полей
14 полей · 3 группыВсе поля описания переноса: три реквизита типа, два списка, шесть свойств поля и три свойства права. Имена с заглавной буквы используются в Git YAML; рядом приведены имена JSON обоих ZIP.
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится пояснение.
Ключ определяет сопоставление. Сравнивается — разница учитывается при построении плана. По элементам — список разбирается на команды частей. Обнаруженное отличие не всегда может быть записано: ограничения указаны рядом с полем.
Сам тип · 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 может быть отклонён.
Команды плана
Три кода команд. Пиктограммы действий имеют подписи по наведению, клавиатуре и нажатию. Приёмник БД исполняет SQL; Git собирает сохраняемое описание из выбранных команд. Выгрузки в S3 и «Файл пакета» создают новый ZIP.
CTPСам составной тип
Create создаёт пустой тип, затем отдельные CTP.Item добавляют поля. Корневая команда также назначает владельца — всегда, даже если он совпадает со Schema. Update меняет только владельца. Разница только в Items или Grants не требует Update CTP. Исключение — порядок полей, которого в базе не получить: тогда в плане появляется Update CTP с отказом, а поля и права типа ждут его и не выполняются; см. ограничение порядка.
Ключ: Схема.Имя типа
CTP.ItemПоле составного значения
Create добавляет поле в конец; Update меняет его тип, длину, числовую точность или точность времени; Delete удаляет поле, отсутствующее в списке источника. При применении используется ALTER TYPE ADD / ALTER / DROP ATTRIBUTE, без автоматического RENAME, CASCADE или преобразования USING.
Ключ: Схема.Имя типа|Имя поля
CTP.GrantПраво использовать тип
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, но без передачи.
Update CTP.Item · parus.udo_request_value|codeменяет тип поля на varchar(40).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 отсортировать команды перед применением: указывают, какая должна выполниться раньше. Для составного типа недостаточно создать пустое определение — функция должна дождаться и его полей.
Create CTP + Create CTP.ItemCreate JFPКаталог правил
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
YAMLCompositeTypePostgres/parus.udo_request_value.yamlSchema, CompositeTypeName, Owner, вложенные Items и Grants. Имена полей с заглавной буквы.
Holkas сохраняет описание в YAML и восстанавливает тот же тип со списками. Сведения о репозитории находятся в .holkas.S3
JSON в ZIPCompositeTypePostgres/parus.udo_request_value.jsonРеквизиты, items и grants внутри одного JSON, с именами полей с маленькой буквы.
Holkas создаёт ZIP в S3, берёт состав из manifest.json и загружает JSON указанного типа.Файл пакета
JSON в ZIPCompositeTypePostgres/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 и хранения, без нового переноса в БД и без проверки клиентов Паруса.