Генератор чисел базы · PostgreSQL и Oracle
Последовательность выдаёт новые целые числа, например номера записей таблицы доработки КОР Парус 8. Holkas переносит правила выдачи и права доступа. Число, до которого дошёл источник, в описание не входит.
SQP / JSQ + Схема.ИмяЧто это за объект
Тип объекта в Holkas: SQP — последовательность PostgreSQL, JSQ — последовательность Oracle. Это физический объект СУБД, самостоятельный по отношению к таблице. В PostgreSQL число запрашивают через nextval, в Oracle — через NEXTVAL. Один генератор может обслуживать несколько потребителей.
Например, учебная parus.udo_seq_request выдаёт числа с шагом 5. Если источник уже выдал 1001, а приёмник 5001, одно это различие не даст команды: Holkas не читает last_value / LAST_NUMBER. Изменение кэша создаст Update настроек, а не команду «установить 1001».
SQP и JSQ — разные описания, автоматического перевода между СУБД нет. Порядок ORDER есть только у Oracle; владелец как отдельная роль Owner — только у PostgreSQL. Последовательность не обещает номера без пропусков: резервирование кэша и получение номера в отменённой транзакции могут оставить пропуски.
Что входит в перенос
Папки каталога Паруса у последовательности нет: ни имя папки, ни путь с родителями не читаются и не создаются. Schema — схема СУБД; SequencePostgres/SequenceOracle в экспорте — каталоги файлов.
Справочник полей
23 поля · 3 группы10 свойств PostgreSQL, 10 Oracle с вычисляемым Owner и 3 поля одной выдачи права. Большая буква соответствует YAML, маленькая — JSON обоих ZIP. Списка зависимостей и текстового Body у последовательности нет.
Как читать обозначения
Подсказка значка открывается мышью, клавишей Tab или нажатием.
Ключ задаёт сопоставление; «Сравнивается» — обнаруживаемую разницу; «По элементам» — команды прав. Разница в плане не гарантирует, что СУБД разрешит выбранную настройку. Все числовые настройки выдачи задаются целыми.
Последовательность PostgreSQL · SQP10 полей
SchemaSQP · JSON: schemaстрокаЧасть ключаСхема последовательности- Назначение
- Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle. У Oracle это одновременно пользователь-владелец.
- При переносе:
- Вместе с Name задаёт адрес. Смена схемы означает другой объект; прежний автоматически не перемещается и не удаляется. Схему или пользователя эта команда не создаёт.
NameSQP · JSON: nameстрокаЧасть ключаИмя без схемы- Назначение
- Например udo_seq_request. Это имя самой последовательности, а не использующей её таблицы или колонки.
- При переносе:
- Если адреса Схема.Имя нет в приёмнике, появляется Create SQP / JSQ. Новое имя не переименовывает прежний счётчик и не переключает на него потребителей.
OwnerSQP · JSON: ownerстрокаСравниваетсяРоль-владелец- Назначение
- Роль, владеющая объектом; может отличаться от Schema. Это не связь OWNED BY с колонкой.
- При переносе:
- Имя сравнивается и назначается через ALTER SEQUENCE … OWNER TO; роль должна существовать и быть доступна для назначения. Пустое или пропущенное значение — ошибка файла: перенос останавливается до плана и называет объект. Роль схемы не подставляется.
DataTypeSQP · JSON: dataTypeстрока: smallint / integer / bigintСравниваетсяТип числа- Назначение
- Тип AS последовательности PostgreSQL; от него зависят допустимые пределы. Читается из pg_sequences.data_type.
- При переносе:
- Пишется в CREATE SEQUENCE … AS и меняется через ALTER SEQUENCE … AS раньше пределов той же команды; текущее число не сдвигается. Иное значение, кроме трёх типов, — отказ с именем объекта. Файл до 0.1.35 поля не содержит — см. тип числа.
MinValueSQP · JSON: minValueцелое: PG int64 / Oracle decimalСравниваетсяНижняя граница- Назначение
- Наименьшее допустимое выдаваемое число. В Oracle decimal сохраняет большие целые точно, а не означает дробную последовательность.
- При переносе:
- Передаётся в CREATE; при Update в ALTER попадает только изменившийся минимум. У новой возрастающей последовательности без START WITH первое число определяется этой границей. Изменение существующей границы может быть отвергнуто из-за положения счётчика приёмника.
MaxValueSQP · JSON: maxValueцелое: PG int64 / Oracle decimalСравниваетсяВерхняя граница- Назначение
- Наибольшее допустимое выдаваемое число. Oracle может выгрузить 9999999999999999999999999999 как обычное число JSON, без кавычек.
- При переносе:
- Передаётся в CREATE и меняется через ALTER при отличии. У новой убывающей последовательности это исходная граница. Holkas не обрезает предел до int64 и не вычисляет его по данным таблицы.
IncrementBySQP · JSON: incrementByцелое: PG int64 / Oracle decimalСравниваетсяШаг выдачи- Назначение
- Положительный шаг увеличивает число, отрицательный уменьшает. Например, 5 задаёт шаг в пять единиц.
- При переносе:
- Изменение даёт Update корня с INCREMENT / INCREMENT BY. 0 не означает «оставить прежний шаг»: он попадёт в SQL и будет отклонён СУБД. Смена шага может повлиять на следующее число приёмника, но не устанавливает число источника.
CacheSQP · JSON: cacheцелое: PG int64 / Oracle int32СравниваетсяСколько чисел резервируется в памяти- Назначение
- Кэш ускоряет выдачу за счёт предварительного резервирования значений. Это количество, а не текущее зарезервированное число.
- При переносе:
- PostgreSQL: 1 — без предварительного запаса; 0 недопустим. Oracle: 0 из каталога записывается как NOCACHE; положительное значение — CACHE N (допустимо от 2). Для Oracle Holkas также превращает отрицательное число в NOCACHE: это не рекомендуемое значение файла. Изменение не заполняет пропуски уже выданных номеров.
CycleSQP · JSON: cycleлогическоеСравниваетсяПовторять диапазон после достижения предела- Назначение
- True разрешает вернуться к противоположной границе: возрастающая последовательность после максимума возвращается к минимуму. False останавливает выдачу у предела.
- При переносе:
- Сравнивается и меняется в обе стороны. При true → false Holkas пишет NO CYCLE (PostgreSQL) / NOCYCLE (Oracle). Это может привести к отказу следующего получения номера у предела; уникальность уже существующих ключей цикличность не проверяет.
GrantsSQP · JSON: grantsсписокПо элементамПрава на последовательность- Назначение
- Выдачи пользователям, ролям и PUBLIC. Это права объекта, а не разрешения прикладного раздела Паруса.
- При переносе:
- Элементы сопоставляются по Grantee:Privilege, порядок несущественен. Разница только в правах даёт SQP.Grant / JSQ.Grant без Update настроек. [] — пустой список прав: лишние выдачи могут быть отозваны. Параметр пропуска лишних прав сохраняет дополнительные выдачи и GRANT OPTION приёмника.
Последовательность Oracle · JSQ10 полей
SchemaJSQ · JSON: schemaстрокаЧасть ключаСхема последовательности- Назначение
- Пространство имён СУБД: например parus в PostgreSQL, PARUS в Oracle. У Oracle это одновременно пользователь-владелец.
- При переносе:
- Вместе с Name задаёт адрес. Смена схемы означает другой объект; прежний автоматически не перемещается и не удаляется. Схему или пользователя эта команда не создаёт.
NameJSQ · JSON: nameстрокаЧасть ключаИмя без схемы- Назначение
- Например udo_seq_request. Это имя самой последовательности, а не использующей её таблицы или колонки.
- При переносе:
- Если адреса Схема.Имя нет в приёмнике, появляется Create SQP / JSQ. Новое имя не переименовывает прежний счётчик и не переключает на него потребителей.
MinValueJSQ · JSON: minValueцелое: PG int64 / Oracle decimalСравниваетсяНижняя граница- Назначение
- Наименьшее допустимое выдаваемое число. В Oracle decimal сохраняет большие целые точно, а не означает дробную последовательность.
- При переносе:
- Передаётся в CREATE; при Update в ALTER попадает только изменившийся минимум. У новой возрастающей последовательности без START WITH первое число определяется этой границей. Изменение существующей границы может быть отвергнуто из-за положения счётчика приёмника.
MaxValueJSQ · JSON: maxValueцелое: PG int64 / Oracle decimalСравниваетсяВерхняя граница- Назначение
- Наибольшее допустимое выдаваемое число. Oracle может выгрузить 9999999999999999999999999999 как обычное число JSON, без кавычек.
- При переносе:
- Передаётся в CREATE и меняется через ALTER при отличии. У новой убывающей последовательности это исходная граница. Holkas не обрезает предел до int64 и не вычисляет его по данным таблицы.
IncrementByJSQ · JSON: incrementByцелое: PG int64 / Oracle decimalСравниваетсяШаг выдачи- Назначение
- Положительный шаг увеличивает число, отрицательный уменьшает. Например, 5 задаёт шаг в пять единиц.
- При переносе:
- Изменение даёт Update корня с INCREMENT / INCREMENT BY. 0 не означает «оставить прежний шаг»: он попадёт в SQL и будет отклонён СУБД. Смена шага может повлиять на следующее число приёмника, но не устанавливает число источника.
CacheJSQ · JSON: cacheцелое: PG int64 / Oracle int32СравниваетсяСколько чисел резервируется в памяти- Назначение
- Кэш ускоряет выдачу за счёт предварительного резервирования значений. Это количество, а не текущее зарезервированное число.
- При переносе:
- PostgreSQL: 1 — без предварительного запаса; 0 недопустим. Oracle: 0 из каталога записывается как NOCACHE; положительное значение — CACHE N (допустимо от 2). Для Oracle Holkas также превращает отрицательное число в NOCACHE: это не рекомендуемое значение файла. Изменение не заполняет пропуски уже выданных номеров.
CycleJSQ · JSON: cycleлогическоеСравниваетсяПовторять диапазон после достижения предела- Назначение
- True разрешает вернуться к противоположной границе: возрастающая последовательность после максимума возвращается к минимуму. False останавливает выдачу у предела.
- При переносе:
- Сравнивается и меняется в обе стороны. При true → false Holkas пишет NO CYCLE (PostgreSQL) / NOCYCLE (Oracle). Это может привести к отказу следующего получения номера у предела; уникальность уже существующих ключей цикличность не проверяет.
OrderJSQ · JSON: orderлогическоеСравниваетсяСтрогий порядок выдачи- Назначение
- True требует выдавать номера в порядке запросов, в том числе при работе узлов RAC. Это не сортировка строк таблицы, не порядок команд Holkas и не запрет пропусков.
- При переносе:
- CREATE задаёт ORDER / NOORDER, Update меняет признак в обе стороны при отличии. В PostgreSQL этого поля и аналогичной настройки Holkas нет.
GrantsJSQ · JSON: grantsсписокПо элементамПрава на последовательность- Назначение
- Выдачи пользователям, ролям и PUBLIC. Это права объекта, а не разрешения прикладного раздела Паруса.
- При переносе:
- Элементы сопоставляются по Grantee:Privilege, порядок несущественен. Разница только в правах даёт SQP.Grant / JSQ.Grant без Update настроек. [] — пустой список прав: лишние выдачи могут быть отозваны. Параметр пропуска лишних прав сохраняет дополнительные выдачи и GRANT OPTION приёмника.
OwnerJSQ · JSON: не сохраняетсявсегда nullСлужебноеОтдельного владельца нет- Назначение
- Владелец Oracle уже определён через Schema. Вычисляемое Owner нужно общей модели прав.
- При переносе:
- Не задаётся и не сохраняется: null опускается в YAML/JSON. Смена Schema адресует другую последовательность, а соответствие ролей меняет только получателей Grants.
Право на последовательность · SQP.Grant / JSQ.Grant3 поля
GranteeSQP.Grant / JSQ.Grant · JSON: granteeстрокаЧасть ключаКому выдано право- Назначение
- Пользователь, роль или PUBLIC. PUBLIC означает всех пользователей, а не роль, которую нужно создать.
- При переносе:
- Вместе с Privilege определяет ключ выдачи. Замена получателя даёт Delete прежнего и Create нового права. Имена приводятся к строчным в PostgreSQL и заглавным в Oracle, PUBLIC остаётся PUBLIC. Роль должна уже существовать; замены задаются параметром соответствия ролей. Неявные права владельца в этот список не включаются.
PrivilegeSQP.Grant / JSQ.Grant · JSON: privilegeстрокаЧасть ключаЧто разрешено- Назначение
- PostgreSQL: USAGE для nextval/currval, SELECT для currval, UPDATE для nextval/setval. Oracle: SELECT для NEXTVAL/CURRVAL; ALTER разрешает менять настройки.
- При переносе:
- Код приводится к верхнему регистру. Замена привилегии означает отзыв прежней и выдачу новой. Holkas не переводит коды прав Oracle в PostgreSQL. Наличие привилегии не означает перенос или создание самой роли.
WithGrantOptionSQP.Grant / JSQ.Grant · JSON: withGrantOptiontrue / nullСравниваетсяМожно передать право дальше- Назначение
- True разрешает получателю выдавать привилегию другим. Null — обычное право; false нормализуется в null и не сохраняется отдельным false.
- При переносе:
- При прежнем ключе изменение даёт Update права. PostgreSQL снимает только GRANT OPTION; Oracle для снятия отзывает привилегию и выдаёт её снова без передачи. Перед отзывом права, переданного дальше, Holkas отказывает, чтобы не снять доступ скрытым каскадом.
Команды плана
Четыре кода: настройки и права для каждой СУБД. У корня только Create/Update; Delete есть у выдачи права. Команд SetOrder и установки текущего числа нет.
PostgreSQL · SQP2 кода
SQPНастройки последовательности PostgreSQL
Создаёт отсутствующую последовательность либо меняет существующую через ALTER без DROP/CREATE. В ALTER включаются только отличающиеся диапазон, шаг, кэш и цикличность. Непустой Owner назначается отдельно в той же корневой команде. START WITH, RESTART и установка числа источника не выполняются. Права меняют отдельные команды.
Ключ: Схема.Имя последовательности
SQP.GrantВыдача, отзыв и передача права
Create выдаёт отсутствующее право; Delete отзывает право, отсутствующее в списке из набора; Update меняет только возможность передать его дальше. Снятие передачи — REVOKE GRANT OPTION FOR, сама привилегия остаётся. Отзыв переданного дальше права защищён от скрытого каскада. Смена имени получателя или привилегии даёт Delete/Create, а не переименование выдачи.
Ключ: Схема.Имя последовательности|Получатель:Привилегия
Oracle · JSQ2 кода
JSQНастройки последовательности Oracle
Создаёт отсутствующую последовательность либо меняет существующую через ALTER без DROP/CREATE. В ALTER включаются только отличающиеся диапазон, шаг, кэш и цикличность. Дополнительно меняется ORDER / NOORDER; Cache=0 записывается как NOCACHE. START WITH, RESTART и установка числа источника не выполняются. Права меняют отдельные команды.
Ключ: Схема.Имя последовательности
JSQ.GrantВыдача, отзыв и передача права
Create выдаёт отсутствующее право; Delete отзывает право, отсутствующее в списке из набора; Update меняет только возможность передать его дальше. Снятие передачи требует REVOKE и повторного GRANT без опции. Отзыв переданного дальше права защищён от скрытого каскада. Смена имени получателя или привилегии даёт Delete/Create, а не переименование выдачи.
Ключ: Схема.Имя последовательности|Получатель:Привилегия
Пример: изменились кэш и право
В приёмнике Cache=20, reader имеет USAGE с передачей. В источнике Cache=40 и то же право без передачи; остальные поля совпадают.
Update SQP · parus.udo_seq_requestвыполняетALTER SEQUENCE parus.udo_seq_request CACHE 40;.Update SQP.Grant · parus.udo_seq_request|reader:USAGEснимает GRANT OPTION, сохраняя USAGE. Эта команда ждёт корень.
Если отличается только право, первой команды нет. Если поменять только положение счётчика при совпавших настройках, нет обеих. На Git это изменения сохранённого описания; приёмники S3 и «Файл пакета» записывают новый ZIP.
Ограничения и что с ними делать
В таблице уже есть записи с номерами
Пусть в приёмнике есть ключи до 8000, а последовательность создаётся с MinValue=1, положительным шагом и Cycle=false. Первое число новой последовательности определяется её минимумом, а не максимумом ключей таблицы. Применение настроек может пройти, а последующая вставка — столкнуться с существующим ключом.
Отдельно согласуйте следующее число с данными средствами своей СУБД перед включением потребителей. Holkas не вычисляет его по MAX и не добавляет такую команду автоматически. Простое совпадение текущих номеров тоже не предотвращает коллизий между независимо работающими базами.
Новая граница противоречит состоянию приёмника
Например, приёмник уже дошёл до 5000, а файл требует поднять MinValue до 6000. Oracle может отклонить ALTER, потому что минимум превысит текущее значение. Holkas не сбрасывает счётчик ради прохождения такой команды.
Если изменился только кэш, совпавшие границы в ALTER вообще не включаются. При настоящем конфликте скорректируйте диапазон в наборе или подготовьте состояние последовательности отдельно; повтор неизменённой команды причину не устраняет.
Новый адрес и отсутствие в наборе
Смена Schema или Name — другой объект: при отсутствии нового адреса создаётся новая последовательность. Старый счётчик не переименовывается и не удаляется, ссылки nextval / NEXTVAL сами не переписываются.
Delete целой SQP/JSQ из отсутствия в наборе не выводится. Это не отменяет Delete прав внутри выбранного объекта. Измените потребителей отдельно, если они должны использовать новый генератор.
Не задан владелец PostgreSQL
Файл SQP, где Owner пропущен или пуст, не переносится: план не строится, а отказ называет последовательность. Приёмник не меняется. Так же ведут себя все объекты PostgreSQL с владельцем: таблица, представление, функция, процедура и составной тип.
Выгрузите объект из базы заново или впишите нужную существующую роль в Owner.
Тип числа последовательности PostgreSQL
Тип AS smallint / integer / bigint переносится полем DataType. Например, источник AS integer с пределом 100000 создаётся в приёмнике тоже integer, а не bigint по умолчанию PostgreSQL. Отличие одного только типа даёт команду Update. Если тип расширяется вместе с пределом, например integer → bigint и MAXVALUE 9000000000, обе правки уходят одной командой ALTER: сначала AS, затем предел.
Файл, выгруженный до 0.1.35, типа не содержит. Такой файл не меняет тип существующей последовательности, а новую создаёт без AS, то есть как bigint; план говорит об этом заметкой. Чтобы перенести тип, выгрузите последовательность заново.
Owner и OWNED BY колонки — разные свойства
Owner — роль-владелец. Связь PostgreSQL OWNED BY привязывает последовательность к колонке, чтобы удаление колонки или таблицы удаляло и последовательность. Holkas эту связь не читает и не создаёт: перенесённая последовательность независима.
В стандартной базе Паруса таких связей нет, номера выдают функции через nextval. Если связь есть в вашей доработке и она нужна, поставьте её в приёмнике отдельно командой ALTER SEQUENCE … OWNED BY.
Сохранённое начало и специальные режимы
START WITH — сохранённое начало выдачи, отличное от текущего числа. Его тоже нет в модели. Если у источника MinValue=1 и START WITH 100, новый приёмник с тем же минимумом не получит начало 100. Подготовьте нужное начало отдельно, если оно существенно для сценария.
Это справка о перечисленных полях, а не полном DDL всех версий СУБД. В частности, специальные режимы последовательностей новых Oracle (SESSION, SCALE, SHARD) и PostgreSQL UNLOGGED отдельными реквизитами не описаны. Не используйте равный план как подтверждение переноса непредставленных настроек.
Роли и право, переданное дальше
Роли должны существовать; Holkas не создаёт их из Grants. Для других имён настройте соответствие ролей и владельцев. Holkas использует строчные имена ролей PostgreSQL и заглавные Oracle. Настоящие роли другого регистра не поддержаны: используйте соответствие с обычной ролью приёмника. Схема и полномочия выполнять CREATE / ALTER / GRANT также должны быть подготовлены.
Если reader передал SELECT другой роли, отзыв или снятие передачи может быть отклонено: PostgreSQL отказывает без CASCADE, Oracle Holkas предварительно проверяет по каталогу. Разберите последующие выдачи отдельно или оставьте это право в Grants переносимого описания. Не обещайте сохранение всех уже применённых команд при отказе другой: режимы транзакций различаются.
Регистрация PostgreSQL в справочнике Паруса
Перенесённая SQP регистрируется в sys.ppc$cnv$sequences через справочник конвертера. Если служебного каталога или функции регистрации нет либо схема не совпадает с TARGET_SCHEMA конвертера, этот шаг пропускается. Он не устанавливает рабочий счётчик, не восстанавливает OWNED BY и не создаёт использующие последовательность программы. Общие границы регистрации →
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas отсортировать команды: указывают, какая должна выполниться раньше. Например, новая колонка с умолчанием nextval должна дождаться создания последовательности.
Create SQP · parus.udo_seq_requestCreate TBP.Col · parus.udo_t_request|rnКаталог ниже охватывает собственные команды прав, непосредственных потребителей PostgreSQL, сохранённые зависимости Oracle и скрипты автора: 10 правил. Это не рекурсивный каталог всех зависимостей базы.
Права после корняПравил: 2
Create / Update SQP→Create / Update / Delete SQP.GrantКогда: Команды относятся к одной последовательности и присутствуют в плане.
Права применяются после создания или изменения корня. Сам ALTER настроек ACL не переписывает; отдельного ожидания изменения каждого права у потребителей нет.
Create / Update JSQ→Create / Update / Delete JSQ.GrantКогда: То же условие для Oracle.
Сначала подготовить последовательность, затем выдать, отозвать или изменить право.
Потребители PostgreSQLПравил: 3
Create SQP→Create / Update TBP.ColКогда: Скан Default колонки распознал nextval. Квалифицированная ссылка даёт настоящую зависимость; имя без схемы подтверждается перечнем источника.
Короткое имя проверяется в схеме таблицы и parus. Неподтверждённый короткий кандидат только упорядочивает совпавшие команды. Колонка ждёт Create последовательности, а не её Update; OWNED BY этим не создаётся.
Create / Update SQP→Create / Update JVPКогда: В Dependencies представления указан адрес SQP из каталога PostgreSQL.
Представление с nextval требует существующую последовательность. Наличие ссылки не означает, что неизменившаяся последовательность получит отдельную команду.
Create / Update SQP→Create / Update JVPКогда: У старого файла JVP Dependencies=null; скан определения встретил совпавшее имя.
Запасной поиск кандидатов только упорядочивает имеющиеся команды. При Dependencies=[] этот скан не включается; случайное имя в тексте не объявляется обязательной опорой.
Каталог OracleПравил: 2
Create / Update JSQ→Команда потребителя Oracle, кроме DeleteКогда: Dependencies у JFN, JPR, JPG, JVW или триггера JTB.Trg содержит адрес последовательности.
Ожидание получают также не удаляющие команды частей и прав соответствующего корня. Синоним может дать ссылку и на JSY, и на конечную JSQ; сама JSY допускает отсутствующую цель.
Create / Update JSQ→Команда дальнейшего потребителя Oracle, кроме DeleteКогда: Подтверждённая ссылка идёт через объект без команды корня, и его описание с Dependencies присутствует в наборе.
Например, новая процедура использует совпавшую функцию, которая обращается к последовательности. Цепочка зависимостей продолжается до JSQ. Без описания промежуточного объекта Holkas не восстанавливает всю базу по догадке.
Скрипты автораПравил: 3
Create / Update SCR Before→Команда выбранной последовательности или её праваКогда: Приёмник выполняет скрипты; скрипт «до» привязан к этому типу и адресу, есть реальные команды объекта.
Сначала выполнить подготовительный SQL скрипта. Отказ или снятие этой команды затрагивает зависимые команды последовательности.
Команда выбранной последовательности или её права→Create / Update SCR AfterКогда: Приёмник выполняет скрипты; скрипт «после» привязан к этому объекту.
Выполнить скрипт после всех команд объекта, включая отзывы прав. Само значение Order Oracle не создаёт такого ребра.
SCR Before → все команды переноса→Все команды переноса → SCR AfterКогда: Приёмник выполняет скрипты; у скрипта Objects=[].
Это тот же порядок для всего переноса, включая SQP/JSQ и Grants. Без обычных команд скрипт убирается из плана; рёбра не означают перенос рабочего счётчика автоматически.
Граница этого графа
Самой последовательности ссылаться на другие физические объекты не требуется; у SQP/JSQ нет списка Dependencies, ребра на папку или отдельного ребра на роль-владельца. Рёбра к последовательности появляются у команд её потребителей. Число правил выше — каталог условий, а не число рёбер каждого плана.
Выбор последовательности не включает все таблицы и программы, использующие её числа. Скан функции PostgreSQL не строит полный граф запросов тела; отсутствие ребра к nextval в такой функции не доказывает, что последовательность ей не нужна. Общее ребро не обещает ожидания всех SQP.Grant / JSQ.Grant: права и полномочия исполнения нужно подготовить отдельно. Недостающие зависимости →
Как последовательность хранится в файлах
Ищите SequencePostgres/ или SequenceOracle/. Для учебных адресов parus.udo_seq_request и PARUS.UDO_SEQ_REQUEST настройки и права сохраняются в одном файле. Отдельных файлов Grant нет.
Git
YAMLSequencePostgres/parus.udo_seq_request.yamlSchema, Name, Owner, настройки и вложенный Grants. Для Oracle — SequenceOracle/PARUS.UDO_SEQ_REQUEST.yaml, с Order и без отдельного Owner.
S3
JSON в ZIPSequencePostgres/parus.udo_seq_request.jsonТот же состав с именами schema, name, owner, grants. Oracle хранится в SequenceOracle/PARUS.UDO_SEQ_REQUEST.json.
Файл пакета
JSON в ZIPSequencePostgres/parus.udo_seq_request.jsonСкачиваемый ZIP включает собственный manifest.json и такой же JSON настроек с grants. Для Oracle — отдельный каталог SequenceOracle.
Выгрузка формирует скачиваемый ZIP; загрузка читает состав и JSON из архива. Запись и чтение для S3 и для файла пакета проверены отдельно.Для SQP/JSQ оба ZIP имеют одинаковое устройство объекта и читаются обоими транспортами. Это результат проверки последовательностей, а не обещание одинаковой раскладки всех типов. Git хранит имена полей с заглавной буквы, JSON — с маленькой; false, нули и пустые списки сохраняются, null опускается.
В manifest.json запись имеет вид {"typeCode":"SQP","name":"parus.udo_seq_request"} либо {"typeCode":"JSQ","name":"PARUS.UDO_SEQ_REQUEST"}. Общие метаданные и СУБД — в справке о пакете. Небезопасные символы имени кодируются: / становится %2F; код внутри файла от этого не меняется. Не переименовывайте файл отдельно от адреса объекта.
Полное учебное описание PostgreSQL: YAML и JSON
Пример записан самим Holkas и прочитан обратно. Роли reader и parus, схема и права переноса должны быть подготовлены в вашей базе. Это учебная последовательность с правом USAGE и передачей, без установки текущего числа.
Git — SequencePostgres/parus.udo_seq_request.yaml
Schema: parus
Name: udo_seq_request
Owner: parus
MinValue: 1
MaxValue: 100000
IncrementBy: 5
Cache: 20
Cycle: false
Grants:
- Grantee: reader
Privilege: USAGE
WithGrantOption: true
DataType: integer
S3 и «Файл пакета» — SequencePostgres/parus.udo_seq_request.json
{
"schema": "parus",
"name": "udo_seq_request",
"owner": "parus",
"minValue": 1,
"maxValue": 100000,
"incrementBy": 5,
"cache": 20,
"cycle": false,
"grants": [
{
"grantee": "reader",
"privilege": "USAGE",
"withGrantOption": true
}
],
"dataType": "integer"
}
Удаление единственного элемента из Grants означает отзыв права. Не используйте [] как условное обозначение скрытых выдач.
Чем отличается файл Oracle
Сокращённый фрагмент файла, записанного Holkas. Schema и Name заглавные; Cache=0 означает NOCACHE, Order=true — ORDER. Минимум, максимум и шаг — числа, не строки. Grants здесь опущен только для краткости: это не готовый файл импорта.
{
"schema": "PARUS",
"name": "UDO_SEQ_REQUEST",
"minValue": 1,
"maxValue": 9999999999999999999999999999,
"incrementBy": 5,
"cache": 0,
"cycle": false,
"order": true
}
В YAML соответствующие имена — MinValue, MaxValue, Cache, Cycle, Order; значения имеют те же типы. Сохраняйте 28-разрядные целые без округления редактором: JSON Holkas читает их как decimal.
В SQL-файл выгружается декларативный CREATE SEQUENCE и выдачи прав; PostgreSQL также добавляет ALTER OWNER. Это описание создания, а не готовая разница с существующим приёмником. START WITH отсутствует и здесь. Практические шаги: Git, файл пакета, SQL-файл.
Основа справки: текущие модели, каталоги, построители команд, исполнители и писатели Holkas 0.1.30; семантика последовательностей — PostgreSQL CREATE SEQUENCE и Oracle CREATE SEQUENCE. Сверено 9 ноября 2026. Примеры учебные; выполнены локальные проверки планов, SQL и файлов, нового переноса в БД не было.