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

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

Последовательность

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

PostgreSQL

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

Oracle

В командной строке: --object SQP:parus.udo_seq_request или --object JSQ:PARUS.UDO_SEQ_REQUEST · как задать состав в CLI

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

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

Генератор чисел базы · 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».

Сходимость настроек не синхронизирует номера и строки таблиц. При создании START WITH не задаётся: возрастающая последовательность начинает от MinValue, убывающая — от MaxValue. При Update Holkas не пересоздаёт последовательность и не вызывает setval / RESTART. Изменения шага, кэша и цикличности всё же влияют на последующую выдачу.

SQP и JSQ — разные описания, автоматического перевода между СУБД нет. Порядок ORDER есть только у Oracle; владелец как отдельная роль Owner — только у PostgreSQL. Последовательность не обещает номера без пропусков: резервирование кэша и получение номера в отменённой транзакции могут оставить пропуски.

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

Используют, но не входят в состав: таблицы, представления, функции и процедуры. Их определения и данные не добавляются выбором последовательности.
Диапазон и поведение — реквизиты самой последовательности. Вложенная часть только одна: список прав. Для Oracle — её поля. У прав отдельные команды, но нет собственных файлов.

Папки каталога Паруса у последовательности нет: ни имя папки, ни путь с родителями не читаются и не создаются. Schema — схема СУБД; SequencePostgres/SequenceOracle в экспорте — каталоги файлов.

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

23 поля · 3 группы

10 свойств PostgreSQL, 10 Oracle с вычисляемым Owner и 3 поля одной выдачи права. Большая буква соответствует YAML, маленькая — JSON обоих ZIP. Списка зависимостей и текстового Body у последовательности нет.

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

Ключ задаёт сопоставление; «Сравнивается» — обнаруживаемую разницу; «По элементам» — команды прав. Разница в плане не гарантирует, что СУБД разрешит выбранную настройку. Все числовые настройки выдачи задаются целыми.

Последовательность 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 отказывает, чтобы не снять доступ скрытым каскадом.
Пустые и пропущенные значения в файле

При чтении JSON из обоих ZIP список Grants обязателен: пропуск или null отклоняется, [] означает пустой список прав. При чтении YAML пропуск Grants может дать null; это не корректное пустое состояние для плана. Не сокращайте полный экспорт до учебного фрагмента.

Отсутствующее скалярное поле не означает «сохранить прежнее»: часть чисел и флагов при чтении может восстановиться как 0 и false. Эти значения участвуют в сравнении. Для выключенной цикличности false корректен; нулевой шаг — ошибка. Не рассчитывайте на проверку всех ограничений СУБД при чтении файла.

Какие права сравниваются

PostgreSQL читает явные ACL объекта; неявная выдача владельца самому себе исключена, PUBLIC сохраняется. Oracle читает доступные ALL_TAB_PRIVS и объединяет выдачи разных авторов по получателю и привилегии: GRANT OPTION остаётся, если хотя бы одна выдача разрешает передачу. Автор выдачи не переносится.

При повторе одного ключа в файле Holkas оставляет GRANT OPTION только при true у всех повторов. Перестановка и одинаковые повторы не задают новый порядок. В обычном режиме лишние права отзываются; параметр пропуска лишних прав сохраняет их, включая лишнее разрешение передачи.

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

Четыре кода: настройки и права для каждой СУБД. У корня только Create/Update; Delete есть у выдачи права. Команд SetOrder и установки текущего числа нет.

PostgreSQL · SQP2 кода
SQP
CreateUpdate

Настройки последовательности PostgreSQL

Создаёт отсутствующую последовательность либо меняет существующую через ALTER без DROP/CREATE. В ALTER включаются только отличающиеся диапазон, шаг, кэш и цикличность. Непустой Owner назначается отдельно в той же корневой команде. START WITH, RESTART и установка числа источника не выполняются. Права меняют отдельные команды.

Ключ: Схема.Имя последовательности

SQP.Grant
CreateUpdateDelete

Выдача, отзыв и передача права

Create выдаёт отсутствующее право; Delete отзывает право, отсутствующее в списке из набора; Update меняет только возможность передать его дальше. Снятие передачи — REVOKE GRANT OPTION FOR, сама привилегия остаётся. Отзыв переданного дальше права защищён от скрытого каскада. Смена имени получателя или привилегии даёт Delete/Create, а не переименование выдачи.

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

Oracle · JSQ2 кода
JSQ
CreateUpdate

Настройки последовательности Oracle

Создаёт отсутствующую последовательность либо меняет существующую через ALTER без DROP/CREATE. В ALTER включаются только отличающиеся диапазон, шаг, кэш и цикличность. Дополнительно меняется ORDER / NOORDER; Cache=0 записывается как NOCACHE. START WITH, RESTART и установка числа источника не выполняются. Права меняют отдельные команды.

Ключ: Схема.Имя последовательности

JSQ.Grant
CreateUpdateDelete

Выдача, отзыв и передача права

Create выдаёт отсутствующее право; Delete отзывает право, отсутствующее в списке из набора; Update меняет только возможность передать его дальше. Снятие передачи требует REVOKE и повторного GRANT без опции. Отзыв переданного дальше права защищён от скрытого каскада. Смена имени получателя или привилегии даёт Delete/Create, а не переименование выдачи.

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

Пример: изменились кэш и право

В приёмнике Cache=20, reader имеет USAGE с передачей. В источнике Cache=40 и то же право без передачи; остальные поля совпадают.

  1. Update SQP · parus.udo_seq_request выполняет ALTER SEQUENCE parus.udo_seq_request CACHE 40;.
  2. 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 должна дождаться создания последовательности.

Каталог ниже охватывает собственные команды прав, непосредственных потребителей 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

YAML
SequencePostgres/parus.udo_seq_request.yaml

Schema, Name, Owner, настройки и вложенный Grants. Для Oracle — SequenceOracle/PARUS.UDO_SEQ_REQUEST.yaml, с Order и без отдельного Owner.

Git-транспорт сохраняет YAML и при чтении восстанавливает из него описание и права. В корне репозитория — метаданные .holkas.

S3

JSON в ZIP
SequencePostgres/parus.udo_seq_request.json

Тот же состав с именами schema, name, owner, grants. Oracle хранится в SequenceOracle/PARUS.UDO_SEQ_REQUEST.json.

Выгрузка создаёт ZIP в S3; чтение берёт состав из manifest.json и загружает JSON последовательности.

Файл пакета

JSON в ZIP
SequencePostgres/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 и файлов, нового переноса в БД не было.