| Пункт | Значение |
|---|---|
| Имя | DELTA-BASE (BIND документа спецификации DELTA-BASE) |
| TAG ID | 0x1DBL |
| Codec ID | 0x00001DB0 |
| Документ спецификации | 0x00000000/codecs/0x00001DB0/ (цель DECLARE 1DB0) |
| Раздел | 14 1110 (Meta), смещение в разделе C = 27 |
| Kind | Meta · класс: родословная |
| TAG WORD | 0001 1101 1011 LLLL (000K KKKC CCCC LLLL) |
| Описание в индексе | Этот файл версии — diff относительно базовой версии того же документа (ID версии 2 WORD) (git packfile delta) |
| Сторона Hugo | meta/lineage/delta-base.md |
Поля (документ спецификации)
Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | version | #2 | простое значение 2 WORD | 0620 UNSIGNED-INTEGER |
Маркер того, что этот файл версии является не снимком, а diff относительно базовой версии того же документа (delta в git packfile). Сама версия по-прежнему определяется как снимок. Хеш содержимого, список версий и подписи — всё это относится к снимку, восстановленному применением diff (Хранение diff).
Раскладка
TAG WORD 0001 1101 1011 LLLL Codec 0x1DBL
ID версии 2 WORD unsigned (базовая версия того же документа)
- Codec: Meta
0x1DBL, класс родословной - Payload: ID версии 2 WORD (простое значение)
- Количество: не более одного
Интерпретация и валидность
- Используется только в документах с DOC-ID. В списке версий
versions.geul, документах-списках (версииissuers/) и безымянных документах, гдеDOC-IDне ставится, diff не используется. - Базовая версия — опубликованная версия с тем же
DOC-ID, предшествующая этой версии.0(нет версии) — invalid. - Хеш содержимого восстановленного снимка должен совпадать с хешем этой версии в списке версий (PUBLICATION). Если не совпадает, этот diff invalid. Поэтому итоговый хеш внутри diff отдельно не записывается.
- В виде diff может храниться только документ, у которого все записи BODY являются Edge (записями с Edge Id). Это потому, что единица diff — LOCAL ID (Edge Id).
- Правила восстановления снимка следуют Хранению diff. Удаление берёт на себя DELTA-REMOVE.
- Отдельных маркеров добавления и редакции нет. Если Edge Id из BODY diff есть в базе, это редакция, если нет — добавление. Добавление получает номер, начиная с NEXT-LOCAL-ID списка версий. Повторное использование удалённого LOCAL ID — invalid (Редакция).
Пример
diff относительно базовой версии 3:
1DB2 0000 0003
- TAG
1DB2(Meta0x1DBL,LLLL=0010, 3 WORD), ID версии0000 0003.
Открытые проблемы
- Интервал снимков: через сколько версий ставить полный снимок (длина цепочки diff и стоимость восстановления).
- Ограничивать ли базовую версию непосредственно предыдущей.
- Место хранения файла diff: класть ли его на место файла версии (
<ID версии>.geul); связь с адресом по хешу содержимого<Issuer>/hashes/(hashes/ищется по хешу содержимого снимка).
Исходный текст документа спецификации
Документ спецификации 0x00000000/codecs/0x00001DB0/latest.geul, прочитанный командой geul show (16-ричные значения в верхнем регистре).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DB000000000
BODY
#1 DECLARE 0x1DB0
#2 FIELD #1 0x0002
#3 BIND #1 "DELTA-BASE"
#4 BIND #2 "version"
#5 CODEC #2 0x0620