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

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

Набор данных

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

Парус · Oracle и PostgreSQL

Все поля DAT: описание, строки, ключи и адресные ссылки; удаления с prune и без него, команды, ограничения и хранение в Git, S3 и файле пакета.

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

Парус 8 · данные справочников решения

Набор данных переносит записи справочника вместе с их частями: например, словарь статусов и его значения. Описание набора определяет, какие строки читать и по каким ключам узнавать их в другой базе.

ИдентификаторDAT + Name
СтрокаПо ключу · без RN источника
Лишние корниУдаляются только с Prune

Для чего нужен набор данных

DAT — объект Holkas, а не отдельный вид метаданных КОР. Он описывает строки таблиц схемы PARUS: корень, границу выбора, подчинённые таблицы и ссылки. Строение берётся из каталога СУБД, без требования описать таблицу атрибутами класса КОР. Поддерживаются Oracle и PostgreSQL; снимок можно сохранить в Git, S3 или «Файл пакета».

Например, класс переносит устройство раздела, а DAT — выбранные записи его справочника. У словаря EXTRA_DICTS значения принадлежат таблице EXTRA_DICTS_VALUES: их нужно включить в описание как часть. Одно упоминание таблицы в ссылке не переносит её строки.

Набор предназначен для справочников решения, не для переноса документов, проводок или всей базы. Практический пример с карточкой и настоящим планом — перенос словаря статусов; точный синтаксис описания — holkas-dataset/1.

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

DATНабор данныхИмя, описание таблиц, ключей, границы и удалений; снимок выбранных строк

Принадлежность задаётся Parts и By в описании, Parent — в снимке. В файле Rows остаётся плоским списком. Ячейки — реквизиты каждой строки; отдельной части «ссылки» нет.

Используются по ссылке: объекты Holkas и строки других таблиц. Они не становятся частями набора. Внутренние ссылки между его строками проставляет DAT.Ref; отдельного списка объектов DAT.Ref в экспорте нет.
Состав набора задаёт описание, а не выбор всего семейства класса. Физические таблицы и связанные объекты включаются отдельно.

Как задать набор

В каталоге базы готовых DAT нет. В разделе «Перенести» карточка «Новый набор» строит черновик по таблице, позволяет выбрать границу, проверить описание и посмотреть первые корневые строки. Описание сохраняется в манифесте, текущем выборе или передаётся описателем сборки. Снятая галочка выбора не стирает описание.

Описание и снимок — разные вещи: в parameter строки манифеста передаётся JSON только описания, а в файле DAT рядом с Definition находится Rows. Имя описания совпадает с именем строки DAT. Без пригодного описания строка не входит в план. Если описание пришло от текущего запроса, оно определяет чтение базы; Git и ZIP читают сохранённый снимок из файла, не выполняя новый запрос к Парусу.

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

35 полей · 8 групп

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

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

Ключ определяет набор или строку, сравнивается — значение участвует в определении различий, по элементам — коллекция несёт строки или их ячейки. Поля описания управляют чтением и сохраняются в Git; они не являются отдельными колонками плана DAT.

У Create DAT.Row задаются значения новой записи, у Update — изменившиеся колонки. Разрешение изменения проверяют ограничения и триггеры Паруса. Сравнение и команда не гарантируют, что конкретная запись допускает изменение.

Набор целиком 2 поля
DefinitionJSON: definitionобъектСравниваетсяОписание набора
Назначение
Устройство набора: имя, таблицы, ключи, граница и правила удаления. Это собственные настройки DAT, а не отдельный дочерний объект.
При переносе:
В базе строки читаются по описанию набора из источника. В Git изменение сохранённого описания даёт Update DAT даже при прежних строках. Само описание не создаёт таблицы.
RowsJSON: rowsсписок строкПо элементамСнимок строк
Назначение
Плоский список корней и их частей. Родитель записан перед детьми; каждый элемент содержит Table, Segment, Parent, Folder, FolderPath и Cells.
При переносе:
Сопоставляется по Segment. Новая строка получает Create DAT.Row, изменённая — Update, лишняя — Delete с учётом Prune. [] — действительно пустой набор: при Prune=true он может удалить все корни, попавшие в границу приёмника.
Описание набора 4 поля
FormatJSON: formatстрокаСравниваетсяМетка формата
Назначение
Точное значение holkas-dataset/1. Не версия Holkas и не formatVersion оглавления ZIP.
При переносе:
Другой или пропущенный формат отклоняется проверкой описания. Формат сохраняется в Definition каждого снимка.
NameJSON: nameстрокаКлючИмя набора
Назначение
Имя объекта DAT; непустое, без |. В манифесте и запросе имя должно точно совпадать с Definition.Name.
При переносе:
Другое имя обозначает другой набор. Оно не переименовывает таблицу или её строки. Два набора с разными именами могут выбирать одни и те же строки; автоматически согласовывать такие перекрытия Holkas не будет.
RootJSON: rootобъект таблицыСравниваетсяКорневая таблица и её устройство
Назначение
Одна таблица с ключом, границей и возможными частями. Описание её структуры приведено в следующей группе.
При переносе:
Определяет, что читается в базе источника и приёмника. Смена Root меняет область сравнения, а не переносит старую таблицу в новую. Git сохраняет это изменение через DAT.
PruneJSON: pruneлогическоеСравниваетсяУдалять лишние корневые строки
Назначение
false по умолчанию. true разрешает удаление корней, которых нет в снимке источника внутри границы.
При переносе:
При false лишний корень сохраняется со всеми своими частями. Лишние части совпавшего родителя могут удаляться при обоих значениях. При чтении БД строки за границей не сравниваются. Git сравнивает сохранённый Rows, не фильтруя его повторно по Where.
Таблица: Root и элементы Parts 7 полей
TableJSON: tableстрокаСравниваетсяИмя таблицы
Назначение
Например EXTRA_DICTS: заглавными, без схемы и внешних пробелов. Схема всегда PARUS. Таблица встречается в дереве набора только один раз.
При переносе:
Должна существовать и иметь пригодные колонки и ключи. Набор не создаёт физическую таблицу. Для PostgreSQL её можно включить отдельно как TBP в тот же план.
ByJSON: byстрока / nullСравниваетсяКолонка непосредственного родителя
Назначение
Только у части: например PRN, с внешним ключом на таблицу родителя. У корня — null.
При переносе:
RN родителя находится в приёмнике и записывается при создании части. By не включается в Cells, Key или Refs. Изменение принадлежности означает другой сегмент части, а не перенос через Update прежнего RN.
KeyJSON: keyсписок строкСравниваетсяКолонки ключа строки
Назначение
У корня непустой; у части — ключ внутри родителя. Служебные RN, COMPANY, VERSION, CRN и колонка By сюда не входят.
При переносе:
Уникальность проверяется по ограничению или индексу с учётом организации/версии и родителя. Смена значения ключа даёт другую строку. У части Key=[] использует значения её ячеек, поэтому изменение значения может дать Delete/Create; ограничения этого режима разобраны ниже.
UnitJSON: unitстрока / nullСравниваетсяРаздел корня
Назначение
Код UNITLIST.UNITCODE для определения версии и каталога корня. Только у Root; у частей не задаётся.
При переносе:
Нужен таблице с VERSION или CRN. Если не указан, Holkas ищет единственный раздел по таблице. Нет раздела или найдено несколько — требуется явный Unit. Указанный раздел проверяется на существование.
WhereJSON: whereобъект / nullСравниваетсяГраница корневых строк
Назначение
Обязательна у корня; у частей отсутствует. Ровно один вид: All=true, Folder либо непустой Keys.
При переносе:
Одна граница используется при чтении обоих концов из БД. При чтении из файла берутся сохранённые Rows без повторного отбора. Это не произвольное SQL-условие. Строки частей отбираются по родителям, собственного фильтра у них нет.
RefsJSON: refsсписок ссылокСравниваетсяОписание RN-ссылок таблицы
Назначение
Перечень обычных колонок, хранящих RN других строк. Состав полей ссылки — в отдельной группе.
При переносе:
Задаёт превращение RN в адрес при чтении и обратный поиск при записи. Неописанная RN-ссылка внешнего ключа отклоняется проверкой. Естественный внешний ключ, например UNITCODE → UNITLIST.UNITCODE, едет обычным значением и сам по себе не создаёт ребро.
PartsJSON: partsсписок таблицСравниваетсяОписание подчинённых таблиц
Назначение
Вложенные DataSetTable; у каждой своя By, Key, Refs и возможные Parts. Конструктор предлагает кандидатов по ON DELETE CASCADE.
При переносе:
Окончательный состав задаёт описание. Проверка подтверждает FK к родителю, но не требует CASCADE у каждой вручную добавленной части. Parts=[] означает, что эта таблица не несёт подчинённых таблиц; оно не означает «все части по умолчанию».
Граница: Root.Where 3 поля
AllJSON: allлогическое / nullСравниваетсяВсе корневые строки
Назначение
true выбирает все строки доступной области корня. false самостоятельной границей не является.
При переносе:
Остальные виды границы должны отсутствовать. Для таблицы с VERSION чтение ограничено версией организации, для таблицы с COMPANY — самой выбранной организацией.
FolderJSON: folderстрока / nullСравниваетсяОтбор по папке
Назначение
Непустое имя папки каталога раздела, например Статусы. Таблице нужна колонка CRN.
При переносе:
Берёт строки папок с подходящим именем, без рекурсивного обхода дочерних папок. «Решение/Статусы» — одно имя, не путь. Это фильтр чтения, а не команда перемещения всех строк.
KeysJSON: keysсписок списков строк / nullСравниваетсяОтбор по значениям ключа
Назначение
Например [["STATUS"], ["KIND"]] при Key=["CODE"]. Внутренний список — один полный ключ, внешний — альтернативы.
При переносе:
Число значений соответствует Key; порядок важен. Числа и даты передаются строками, преобразуются по типу колонки. Пустая строка означает поиск отсутствующего значения; у строковой колонки учитывается и SQL NULL, и пустая строка. Keys=[] отклоняется.
Одна ссылка: элементы Refs 5 полей
ColumnJSON: columnстрокаСравниваетсяКолонка RN-ссылки
Назначение
Имя колонки текущей таблицы, без схемы, заглавными. Одну колонку нельзя описать дважды; служебные колонки и By исключены.
При переносе:
Значение сохраняется адресом цели, а не исходным RN. Внешняя ссылка записывается DAT.Row; внутренняя, на таблицу этого набора, — DAT.Ref. У внутренней колонки должен быть разрешён NULL.
TableJSON: tableстрокаСравниваетсяТаблица цели
Назначение
Таблица, на RN которой указывает Column. Может находиться внутри набора или вне его.
При переносе:
Само упоминание не включает её строки в перенос. У внешней цели нужен существующий адрес в приёмнике либо подходящий объект/набор в том же плане.
KeyJSON: keyнепустой список строкСравниваетсяКлюч адреса цели
Назначение
Колонки уникального ключа в порядке значений адреса. Для внутренней цели точно совпадает с Key её таблицы в описании.
При переносе:
RN ищется по значениям ключа в области приёмника. Для ссылки на ACATALOG в Key обязателен DOCNAME: раздел из него определяет организацию/версию строки каталога.
UnitJSON: unitстрока / nullСравниваетсяРаздел внешней цели
Назначение
Уточняет раздел внешней таблицы с VERSION, если тот не определяется однозначно.
При переносе:
У внутренней ссылки не задаётся. Для ACATALOG не выбирает общую версию CatalogTree: деление берётся по DOCNAME адресуемой строки. Разные Unit для одной внешней таблицы отклоняются.
RefsJSON: refsсписок / nullСравниваетсяСсылки внутри ключа внешней цели
Назначение
Описывает только те колонки Key цели, которые сами хранят RN. Каждый элемент снова имеет Column, Table, Key, Unit и Refs.
При переносе:
Адрес раскрывается до обычных значений. У внутренней ссылки этот список не задаётся. Цепочка ключей с возвратом на исходную таблицу отклоняется: конечный адрес из неё не построить.
Одна строка: элементы Rows 6 полей
TableJSON: tableстрокаСравниваетсяТаблица строки
Назначение
Соответствует одной из таблиц Definition.
При переносе:
Определяет таблицу INSERT/UPDATE/DELETE; отдельной схемы в строке нет. Это не разрешение писать в произвольную таблицу вне описания.
SegmentJSON: segmentстрокаКлючТождество строки
Назначение
У корня — представление значений ключа, у части — сегмент родителя / TABLE:ключ. В учебном наборе точек с Key=[CODE] пример сегмента — A/POINTS:2.
При переносе:
Формируется Holkas. При совпавшем сегменте сравниваются папка и ячейки; другой сегмент — другая строка. Не заменяйте его RN и не правьте отдельно от ключевых ячеек. Составной ключ использует U+001F; специальные символы экранируются.
ParentJSON: parentстрока / nullСравниваетсяСегмент непосредственного родителя
Назначение
У корня null, у части — Segment её родителя в том же снимке. Это не номер RN.
При переносе:
Родитель определяет область поиска части и значение By при создании. Его VERSION и CRN наследуются, если соответствующие колонки есть у обоих. Сам Parent не записывается в колонку с таким именем.
FolderJSON: folderстрока / nullСравниваетсяПапка строки корня
Назначение
Имя ACATALOG.NAME, прочитанное по CRN корневой строки. У частей не сохраняется: они наследуют каталог родителя.
При переносе:
Заданное имя ищется в разделе и области приёмника: двух одноимённых папок там не бывает. Если папки нет, недостающие папки создаются по пути FolderPath. Изменение имени перемещает строку. У строки таблицы с каталогом папка обязательна, у строки таблицы без каталога и у строки части её нет: иное план в базу отклоняет до применения.
FolderPathJSON: folderPathсписок строк / nullСравниваетсяПуть папки строки корня
Назначение
Имена папок от первого уровня под корнем каталога раздела до папки строки включительно, например «Решение», «Статусы»; последний элемент равен Folder. Есть только у корневых строк таблицы с CRN. Корень раздела в путь не входит: в приёмнике берётся корень его организации и версии. [] — строка лежит прямо в корне; отсутствие поля — путь неизвестен (набор прежней версии Holkas).
При переносе:
В базе Паруса сравнивается только имя папки: одноимённая папка приёмника используется там, где лежит, и не перемещается. Отсутствующую папку Holkas создаёт по пути: имеющиеся уровни использует, недостающие создаёт под предыдущим. В Git, S3 и «Файле пакета» сравнивается весь путь; его изменение даёт Update DAT.Row. В плане путь показан как «Путь папки»: «Решение / Статусы», пустой — «(корень)». Путь, который кончается не папкой Folder, отклоняет план до применения. Граница Where.Folder пути не использует.
CellsJSON: cellsсписок ячеекПо элементамЗначения колонок
Назначение
Все читаемые обычные колонки таблицы, кроме RN, COMPANY, VERSION, CRN и By; у ячейки есть Column и Value.
При переносе:
При чтении БД ячейки сортируются по имени колонки, отсутствующие значения не записываются. При Update колонка, бывшая в текущей строке и отсутствующая в строке источника, получает SQL NULL. [] не означает «оставить старые значения». Внутренние ссылки обрабатываются DAT.Ref.
Одна ячейка: элементы Cells 2 поля
ColumnJSON: columnстрокаСравниваетсяИмя колонки
Назначение
Каноническое имя обычной колонки, например CODE или NAME.
При переносе:
Должна существовать в таблице приёмника. При изменении имени ячейки прежняя колонка может очищаться, а другая — получать значение; это не переименование колонки таблицы.
ValueJSON: valueобъектСравниваетсяТипизированное значение
Назначение
Один DataValue с Kind и соответствующим полем S, N, D, B или A.
При переносе:
Сравнивается по содержимому. В UPDATE попадают только изменившиеся колонки; адрес перед записью разрешается в RN приёмника. Отсутствие ячейки — отсутствие значения, а не объект Value с произвольными пустыми полями.
Значение ячейки или часть адреса 6 полей
KindJSON: kindстрокаСравниваетсяВид значения
Назначение
s — строка; t — длинный текст; n — число; d — дата; b — байты; a — адрес. Заполнено соответствующее поле ниже.
При переносе:
Читалка базы выбирает вид по типу колонки или описанной RN-ссылке. При записи обычной колонки учитывается тип колонки приёмника. Это коды Holkas, а не DataType домена Паруса.
SJSON: sстрока / nullСравниваетсяСтрока или длинный текст
Назначение
Для Kind=s и Kind=t используется одно поле S.
При переносе:
Пустые строки при чтении БД не дают ячейки. CRLF и LF равны при сравнении, регистр и пробелы значимы. Удаление ячейки очищает колонку; значение 0 сюда не подставляется.
NJSON: nдесятичное / nullСравниваетсяЧисло
Назначение
Для Kind=n. Ноль — настоящее значение.
При переносе:
Читается и записывается числом; 0 не равен отсутствию ячейки. Представления 1.50 и 1.5 дают одно значение ключа. Значения ограничены десятичным типом модели; автоматического преобразования в произвольную точность нет.
DJSON: dдата и время / nullСравниваетсяДата с точностью до секунды
Назначение
Для Kind=d. Например 2026-11-08T12:34:56, без часового пояса.
При переносе:
Чтение БД убирает доли секунды и информацию о зоне, чтобы соответствовать Oracle DATE. Время участвует в сравнении. Не рассчитывайте сохранить миллисекунды или часовой пояс через DAT.
BJSON: bмассив байтов / nullСравниваетсяДвоичное содержимое
Назначение
Для Kind=b. Git пишет список чисел, JSON обоих ZIP — строку Base64.
При переносе:
Байты сравниваются по содержимому и передаются драйверу. Пустое двоичное значение при чтении БД не даёт ячейки; файл с пустым массивом может прочитаться, но это не доказательство сходимости с БД.
AJSON: aсписок значений / nullСравниваетсяАдрес строки-цели
Назначение
Для Kind=a. Значения идут в порядке Key ссылки. У части первым элементом идёт вложенный адрес родителя, затем собственный ключ части.
При переносе:
Например адрес точки 2 маршрута A: [[A], 2]. RN в адрес не включается. Элемент ключа, сам являющийся ссылкой, тоже становится вложенным адресом. Неизвестная или неоднозначная цель приводит к отказу разрешения ссылки.
Отсутствие значения, пустой список и порядок записей

Чтение базы опускает SQL NULL, пустой текст и пустые байты. Ноль сохраняет как число. При изменении строки отсутствие прежней ячейки очищает колонку, если Парус это разрешит. Чтение из файла не превращает любую рукотворную пустую ячейку в корректное состояние базы.

Порядок строк приводит к устойчивому виду сам Holkas: корни по сегменту, под родителем — части в порядке описания. Отдельной команды SetOrder нет. Перестановка строк в файле не задаёт прикладную сортировку справочника; порядок ячеек и порядок полей адреса нельзя менять произвольно.

Вычисляемое IsAddress означает Kind=a. Ни Git YAML, ни JSON ZIP его не сохраняют; пользователь его не задаёт.

Одинаковые имена списков не означают одинаковых правил чтения

При чтении отдельного описания holkas-dataset/1 пропущенные Refs и Parts становятся пустыми списками. Снимок JSON в ZIP требует явно записанные обязательные списки Rows, Cells, Key, Refs и Parts в соответствующих структурах. Пропуск или null не равен []; неполный ZIP отклоняется при чтении. Сохраняйте полный экспорт.

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

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

DAT
CreateUpdate

Описание набора

Create появляется, если текущего набора нет. В БД проверяет описание и ничего не создаёт сверх строк; в Git создаёт файл. Update сохраняет изменившееся описание в файловом приёмнике. База читает текущие строки по описанию набора из источника, поэтому отдельного Update описания обычно нет. Удаление объекта DAT не строится.

Ключ: Имя набора

DAT.Row
CreateUpdateDelete

Строка корня или части

Create получает новый RN, пишет обычные ячейки, разрешает внешние адреса и задаёт область приёмника; внутренние ссылки оставляет для DAT.Ref. Update пишет только изменившиеся колонки; исчезнувшая ячейка очищается. Даже изменение только внутренней ссылки может дать Update DAT.Row без SQL и отдельный DAT.Ref. Delete удаляет строку по найденному RN; если она уже исчезла каскадом, команда считается выполненной.

Ключ: Имя набора|Сегмент строки

DAT.Ref
Update

Внутренние ссылки строки

Появляется для новой строки с заполненной внутренней ссылкой либо при изменении/очистке внутренней ссылки существующей строки. Находит RN строки и её целей, затем одним UPDATE записывает все внутренние колонки-ссылки этой строки. Не создаёт недостающие цели и не переносит внешние ссылки.

Ключ: Имя набора|Сегмент строки

Create/Update/Delete выполняются прямыми INSERT/UPDATE/DELETE с обычными триггерами Паруса. Папка при необходимости создаётся штатной процедурой в составе команды строки, отдельной команды каталога нет. SetOrder не формируется.

Один ключ и разные RN: что изменится

Учебный набор Statuses выбирает словарь CODE=STATUS. В источнике его RN=101, NAME=«Статусы согласования»; в приёмнике RN=9087, NAME=«Статусы». Остальные значения совпадают.

План даст Update DAT.Row с ключом Statuses|STATUS. При применении будет найдена строка с RN=9087 и изменено только NAME. RN=101 в другую базу не записывается. Если заменить CODE на STATUS_NEW и согласовать с этим границу описания, это уже новая строка: прежний корень сохраняется при Prune=false, а при true может удалиться, только если входит в границу сравнения.

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

Prune управляет корнями, а не всеми удалениями

В приёмнике есть словари STATUS и LEGACY, в источнике — только STATUS. Если оба кода входят в границу и Prune=false, LEGACY останется вместе со своими значениями. С Prune=true его части получат Delete перед самим словарём. При чтении приёмника из БД строки за границей не входят в сравнение.

Git читает весь сохранённый снимок: если в файле приёмника остался LEGACY, смена Where на STATUS его не отфильтрует. Prune=false сохранит его, а true разрешит удалить из файла как отсутствующий в Rows источника. Изменение Where само по себе не перечитывает базу и не пересобирает снимок.

Если у совпавшего STATUS есть лишнее значение OLD, оно получает Delete и при Prune=false. Не заменяйте полный снимок сокращённым списком: пустой Rows — настоящее отсутствие строк в источнике, а не просьба пропустить данные.

Отдельный случай: источник без строк по Folder или Keys возвращает dataset_empty, а не пустой снимок для удаления. Пустой снимок читается из БД при All=true либо может быть сохранён в файле. Триггеры и FK могут запретить сформированное удаление.

У части нет устойчивого ключа

При Key=[] сегмент части строится по её непустым строкам, числам и датам; адреса, длинный текст и байты в него не входят. По тем же колонкам Holkas ищет строку в приёмнике внутри родителя. Условное значение OLD → NEW в строке, числе или дате поэтому может дать Delete старой строки и Create новой, а не Update; изменение только длинного текста или байтов даёт Update.

Две строки одного родителя с одинаковым сегментом дают dataset_duplicate_row ещё при чтении, до плана, — в том числе если они различаются только длинным текстом или байтами: приёмник их не различит. Тот же отказ даёт файл Git или пакета с такими строками. Файлы, записанные прежними версиями Holkas, где сегмент включал длинные значения, сходятся без лишних команд. По возможности задайте реальный уникальный бизнес-ключ; не придумывайте колонку по названию.

Организация и версия — область приёмника

RN, COMPANY, VERSION, CRN источника не копируются как ячейки. При создании RN выдаётся заново, COMPANY берётся из подключения или выбора запуска, VERSION корня — через FIND_VERSION_BY_COMPANY по разделу. У части VERSION и CRN наследуются от родителя при наличии колонок. Для внешних адресов используется область таблицы-цели; у ACATALOG — деление раздела из DOCNAME.

Чтение корней, предпросмотр и поиск строки работают в одной области: у таблицы с VERSION — в версии организации, у таблицы с COMPANY — в выбранной организации при любой границе (All, Folder, Keys). Строки других организаций в набор не попадают, одинаковый код в двух организациях не мешает чтению, а Prune не удаляет чужие строки.

Нужно сохранить дерево папок

Для корневой строки из «Раздел → Решение → Статусы» в снимок попадут Folder = «Статусы» и FolderPath «Решение», «Статусы». Корень раздела не записывается. В приёмнике поиск учитывает имя, раздел, организацию и, для раздела с версиями, её версию.

Если папки «Статусы» нет, Holkas проходит путь: найденную «Решение» использует как есть, «Статусы» создаёт под ней; отсутствующую «Решение» тоже создаёт. Папки готовятся внутри команды строки, отдельных строк плана для них нет.

Одноимённая папка, которая в приёмнике уже есть под другим родителем, используется на своём месте и не перемещается. Если строка в приёмнике уже есть, план показывает у набора замечание «Папка с тем же именем в приёмнике лежит в другом месте дерева; объект ляжет в неё, папка не перемещается: …» с сегментом строки. Перенесите такую папку в Парусе вручную, если расположение важно.

В наборе прежней версии Holkas пути нет. При совпадающем имени папки путь берётся у приёмника и команд нет; иначе папка ищется по имени и при отсутствии создаётся под корнем, о чём план предупреждает. Пересоберите снимок из источника, чтобы строки получили путь; в Git, S3 и «Файле пакета» старый снимок без пути получит Update DAT.Row.

Граница Where.Folder по-прежнему задаётся именем папки, а не путём, и не обходит поддерево: «Решение/Статусы» в ней — одно имя.

Поиск папки учитывает версию организации. Это не исправляет строки, которые при переносе версией до 0.1.29 попали в папку чужой версии: совпавшее имя не даёт различия. Для таких старых переносов отдельно сверяйте VERSION строки и её папки; подробнее в заметках к выпуску 0.1.29.

Сброс Folder не равен перемещению в корень

В базе Паруса у таблиц с каталогом колонка CRN обязательна, поэтому строка корня такой таблицы всегда читается с папкой. Если в пакете или репозитории убрать у неё Folder или оставить имя пустым, план в базу откажет до применения с кодом dataset_folder_mismatch и назовёт строки. Так же отклоняется папка у строки таблицы без каталога и у строки части: часть лежит в папке своей родительской строки.

Чтобы переместить строку, укажите настоящее имя нужной папки. Пустое имя или null не перемещают строку в корень.

Парус запрещает изменение или удаление строки

DAT пишет прямой SQL, поэтому действуют ограничения, триггеры, обязательные поля и права Паруса. Например, смена защищённого FORMAT словаря может получить неустранимый отказ: Update всей строки отклонён, а не только одно поле. В обычном режиме независимые строки продолжают выполняться; обычная ошибка может пропустить остаток этого набора.

В режиме одной транзакции отказ останавливает перенос с откатом. Не переносите вывод «остальные строки продолжат работу» на этот режим. Подробнее — применение плана и одна транзакция.

Таблицы или её регистрации ещё нет

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

Регистрация в TABLELIST не заменяется созданием физической таблицы. Её делает перенос раздела CLS; DAT не добавляет его автоматически и не ждёт регистрацию отдельным правилом. Если триггер отвечает «таблица не принадлежит Системе», сначала подготовьте раздел и регистрацию средствами Паруса или соответствующим переносом.

Типы колонок и SQL-файл

Набор знает пять видов колонок: строка, длинный текст, число, дата и двоичные данные. Неподдержанный тип даёт ошибку проверки даже у колонки, которая не входит в ключ. Различия схем Oracle и PostgreSQL не преобразуются автоматически в произвольную новую структуру.

SQL-превью в плане помогает читать действие, но приёмник «SQL-файл» наборы DAT не выгружает. Для переноса снимка используйте базу, Git, S3 или «Файл пакета».

Рёбра команд

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

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

1 · СначалаСоздать маршрутCreate DAT.Row
→
2 · ЗатемСоздать его точкуCreate DAT.Row
Колонка By точки получит RN маршрута из приёмника. Исходный RN не копируется.

Каталог содержит 12 правил: внутри набора, внешние зависимости и скрипты. Это число видов правил, а не количество рёбер в каждом плане.

Внутри набора7 правил
Create DAT→Create DAT.Row корня

Когда: Набор в приёмнике отсутствует, строка — корневая.

Сначала проверить описание нового набора; в Git создать файл, затем наполнить его строками.

Create / Update DAT.Row родителя→Create DAT.Row части

Когда: Команда родителя есть в плане; Parent части называет эту строку.

Новая часть должна получить RN уже существующего родителя. Update существующей части сам по себе родителя не ждёт.

Delete DAT.Row части→Delete DAT.Row родителя

Когда: Обе строки удаляются; часть имеет Parent.

Сначала удалить содержимое, потом родителя. Это ребро не разрешает удалить корень при Prune=false.

Create / Update DAT.Row строки→Update DAT.Ref этой строки

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

Сначала завести или изменить строку, затем проставить её ссылки.

Create / Update DAT.Row цели→Update DAT.Ref ссылающейся строки

Когда: Внутренняя ссылка имеет адрес цели и для той есть команда строки.

Цель может появиться позже самой ссылающейся строки; запись ссылки ждёт обе стороны.

Update DAT.Ref ссылающейся строки→Delete DAT.Row прежней цели

Когда: Текущая внутренняя ссылка указывает на удаляемую строку и переставляется или очищается.

Освободить цель от ссылки до удаления. DAT.Ref не является удалением самого объекта-ссылки.

Delete DAT.Row ссылающейся строки→Delete DAT.Row её цели

Когда: Удаляются обе строки, между ними текущая внутренняя ссылка; прямой взаимной пары нет.

Сначала убрать использование цели. Для взаимной пары ребро не ставится; автоматического разрыва цикла ссылок нет.

Таблицы и внешние ссылки3 правила
Create / Update TBP и частей→Create DAT; Create / Update DAT.Row; Update DAT.Ref

Когда: В том же плане есть TBP parus.таблица для любой таблицы набора: корня или части.

Ждать таблицу, её TBP.Col, TBP.Cns, TBP.Idx и TBP.Trg до проверки строения и записи. Это правило PostgreSQL; ожидание JTB для Oracle не добавляется.

Create / Update объекта Holkas→Create / Update DAT.Row

Когда: Внешний адрес ведёт в известную таблицу по её объектному ключу, например DMSMESSAGES/CODE → MSG.

Подготовить объект, прежде чем записывать его RN. Ребро есть и для Update объекта; оно не ждёт всех его частей автоматически.

Create / Update DAT.Row другого набора→Create / Update DAT.Row потребителя

Когда: Цель — корневая таблица другого набора того же плана с тем же порядком Key; нужная строка есть в его снимке из источника.

Подготовить строку-цель. На часть чужого набора такого ребра нет: цель должна уже находиться в приёмнике.

Скрипты автора2 правила
SCR Before→DAT / DAT.Row / DAT.Ref

Когда: Приёмник исполняет скрипты; область скрипта включает этот набор или весь перенос.

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

DAT / DAT.Row / DAT.Ref→SCR After

Когда: Та же область, время скрипта — After.

Выполнить скрипт после команд набора.

Границы порядка и влияния зависимостей

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

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

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

Как набор данных хранится в файлах

Начните с каталога DataSet/. У набора один файл с описанием и плоским списком строк, включая части. Отдельных файлов DAT.Row или DAT.Ref нет. Учебное имя ниже — Statuses.

Git

YAML
DataSet/Statuses.yaml

Definition и Rows в одном файле, имена PascalCase. Вложенные части не выделяются в свои файлы.

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

S3

JSON в ZIP
DataSet/Statuses.json

definition и rows в одном JSON. В manifest.json набор указан один раз как DAT + имя.

Holkas упаковывает снимок в ZIP и отправляет его в хранилище; при чтении открывает оглавление и файл набора.

Файл пакета

JSON в ZIP
DataSet/Statuses.json

Скачиваемый ZIP содержит такое же устройство DAT: описание и строки вместе, camelCase.

Запись и чтение файла пакета проверены независимо от S3. При чтении берётся весь снимок, а не выполняется запрос по одному имени набора.

Для DAT оба варианта ZIP записывают и читают набор в одном и том же виде. Это результат проверки этого типа, не обещание одинакового размещения всех объектов Holkas. Манифест ZIP содержит {"typeCode":"DAT","name":"Statuses"}; описание находится внутри JSON объекта, не в этой строке оглавления. У манифеста состава операции, напротив, есть parameter с описанием. Подробнее — формат ZIP и манифест состава.

Null-поля при записи опускаются; false, ноль, пустые строки и списки сохраняются. Байты Value.B в YAML — числовой список, в JSON — Base64. Вычисляемого IsAddress нет в обоих форматах. Небезопасный символ в имени файла кодируется: например, / → %2F; имя Definition.Name остаётся прежним. Не переименовывайте файл отдельно от адреса объекта.

Описание и две ячейки одной строки в YAML и JSON

Учебный снимок, прочитанный Holkas из файлов. У него сознательно нет Parts, а показаны только CODE и NAME. Это пример устройства файла, не полный экспорт EXTRA_DICTS и не готовый набор для записи в вашу базу. Для переноса значений словаря нужны настоящие описание частей и все требуемые колонки из полного экспорта.

Git — DataSet/Statuses.yaml

Definition:
  Format: holkas-dataset/1
  Name: Statuses
  Root:
    Table: EXTRA_DICTS
    Key:
    - CODE
    Where:
      Keys:
      - - STATUS
    Refs: []
    Parts: []
  Prune: false
Rows:
- Table: EXTRA_DICTS
  Segment: STATUS
  Cells:
  - Column: CODE
    Value:
      Kind: s
      S: STATUS
  - Column: NAME
    Value:
      Kind: s
      S: Статусы

S3 и «Файл пакета» — DataSet/Statuses.json

{
  "definition": {
    "format": "holkas-dataset/1",
    "name": "Statuses",
    "root": {
      "table": "EXTRA_DICTS",
      "key": [
        "CODE"
      ],
      "where": {
        "keys": [
          [
            "STATUS"
          ]
        ]
      },
      "refs": [],
      "parts": []
    },
    "prune": false
  },
  "rows": [
    {
      "table": "EXTRA_DICTS",
      "segment": "STATUS",
      "cells": [
        {
          "column": "CODE",
          "value": {
            "kind": "s",
            "s": "STATUS"
          }
        },
        {
          "column": "NAME",
          "value": {
            "kind": "s",
            "s": "Статусы"
          }
        }
      ]
    }
  ]
}

Cells — список ячеек, не словарь вида CODE: STATUS. Значения в JSON находятся в value.s, а не прямо в column. [] означает пустую коллекцию; оно не служит сокращением пропущенных элементов.

Практические шаги: карточка и перенос набора, сохранение в Git, выгрузка и загрузка ZIP. Возможности проверки и черновика доступны также через REST и MCP.

Основа: текущие модель, проверка описания, чтение, построение команд, исполнители и три транспорта Holkas 0.1.30; сохранённые исследования справочников и каталогов Паруса. Сверено 9 ноября 2026. Statuses, маршруты и точки — учебные примеры. Нового переноса в БД, проверки клиентов Паруса или сетевой доставки Git/S3 при подготовке страницы не было.