Как это работает / 02 из 05
Как строится план
Отличия превращаются в команды, команды связываются зависимостями, а граф задаёт порядок. Разберём весь путь: от diff до топологической сортировки и выбора части плана.
На этой странице
План — это команды, связи между ними и порядок, который соблюдает эти связи. Список в интерфейсе показывает эту очередь; граф объясняет, почему команды стоят именно так.
Откуда берутся команды
Для переноса в базу Holkas сначала читает выбранные объекты источника и соответствующие объекты приёмника. Сравнение идёт по типам, частям и поддерживаемым полям: какие объекты отсутствуют, какие части добавлены или удалены, какие значения отличаются. Источник задаёт, каким должно быть содержимое, а не обязательно самую новую или правильную версию.
Затем правила каждого типа превращают отличия в команды. Новая функция может дать одну команду Create, изменение её тела — одну Update. Класс устроен иначе: создание самого класса, добавление каждого атрибута и восстановление порядка атрибутов — отдельные команды. Поэтому три выбранных объекта могут дать десятки строк плана.
01 / Из отличия — в действие
Одна правка кода, одна команда Update
− RETURN amount > 0;+ RETURN amount >= 100;Адрес команды в плане
- Тип команды
JFP- Действие
Update- Ключ
parus.f_hksite_contract_check
Текст функции хранится в содержимом изменения. Тип, действие и ключ позволяют отличить эту команду от других и сослаться на неё из зависимости.
У команды есть тип, действие и ключ. Например, JFP / Update / parus.f_hksite_contract_check обозначает обновление функции, а CLS.Attr / Create / Request|STATUS — создание атрибута определённого класса. Команды также сохраняют связь с корневым объектом и сведения о том, что меняется. Благодаря этому план можно показать по объектам, а выполнить по командам.
| Действие | Что означает | Пример |
|---|---|---|
| Create | Создать объект или его часть. | Добавить функцию или атрибут класса. |
| Update | Изменить содержимое. | Заменить тело функции или значение поля. |
| Delete | Удалить часть, когда правила типа это допускают. | Убрать параметр, которого больше нет в исходном методе. |
| SetOrder | Выставить нужный порядок элементов. | Упорядочить атрибуты после их изменений. |
SetOrder не является сортировкой самого плана. Это отдельная команда, которая меняет порядок элементов в объекте Паруса. Сортировка плана определяет, когда эта команда должна выполняться относительно остальных.
Команда может понадобиться и при совпавшем тексте
На Oracle команду получает и объект с тем же текстом, если на приёмнике он невалиден: процедура, функция, пакет, представление, синоним или триггер таблицы. Например, процедура, созданная без нужного пакета, не собирается сама, когда пакет появится, и Парус её не видит. Update заменяет её тем же текстом, и она собирается раньше команд, которые от неё зависят. В строке плана указана причина. Пока ошибку в объекте не исправят, такая команда будет появляться в каждом плане.
Валидный объект из-за изменения его зависимости в план не попадает. Если изменение его испортит, например новая колонка таблицы, Holkas соберёт его на финальном этапе применения.
Как из команд получается граф
Одних команд недостаточно. Атрибут нельзя добавить до создания его класса; атрибут с доменом требует самого домена; итоговый порядок атрибутов нужно выставить после изменений их состава. Holkas записывает такие отношения как рёбра.
Что такое ребро
Ребро — это требование к порядку двух команд: одна должна выполниться раньше другой. Например, «создать домен» раньше, чем «создать атрибут с этим доменом». Слово пришло из графов: команды — точки, рёбра — стрелки между ними.
Ребро — не ссылка между записями базы и не поток данных из одного объекта в другой. Оно ничего не переносит и не добавляет объекты в набор — только задаёт очередь команд, которые уже есть в плане.
В Holkas рёбра видны в карточке команды, в блоке «Зависимости»: про каждую связанную команду сказано, что эта её «ждёт» или «идёт раньше» неё. В справочнике у каждого типа объекта есть раздел «Рёбра команд» — список правил, по которым рёбра появляются.
В наших рисунках А → Б означает «А раньше Б». Вершина — конкретная команда, ребро — стрелка между двумя командами.
Связи появляются из правил типов и известных зависимостей объектов. Например, внешний ключ ждёт таблицу, колонки и подходящий ключ таблицы, на которую ссылается. Представление может ждать создания используемых таблиц и их колонок. Зависимости могут пересекать границы объектов, поэтому команды одного объекта не обязаны идти одним непрерывным блоком.
Для удаления направление требования может быть обратным: сначала убрать зависимую часть, затем то, на что она опиралась. При этом сортировка не даёт права удалять объект: сначала правила типа определяют допустимые команды, затем связи определяют их порядок.
Два способа объявить одну стрелку
Одну стрелку можно записать с любой из двух сторон. Если команда Б сама указывает, что ждёт А, получаем А → Б. Если команда А сама указывает, что Б должна ждать её, получаем ту же стрелку А → Б. Второй вариант используется, в частности, для порядка удалений зависимых частей.
Это способы записать требование со стороны той команды, которая его указала. При сортировке оба превращаются в обычное отношение «раньше → позже»; отдельного обратного запуска плана нет.
Топологическая сортировка по шагам
Holkas использует топологическую сортировку. Для каждой команды подсчитывается число предшественников в построенном графе. Команды без предшественников доступны сразу. Из доступных выбирается одна, ставится в итоговую очередь, и её исходящие связи перестают удерживать последующие команды. Так появляются новые доступные вершины.
В примере ниже исходный порядок построения команд — A, B, C, D, E, F. Это порядок нашего условного примера. Связи заставят поставить домен E раньше атрибута C. Переключайте шаги: цвет показывает состояние команды, число «Ждёт» — сколько её предшественников ещё не поставлено в очередь.
02 / Исследуйте граф
Шесть команд. Пять связей. Один допустимый порядок.
А должна стоять раньше Б. Стрелка обозначает зависимость, а не передачу данных.
CLS · Request Доступна CLS.Attr · AMOUNT Ждёт: 1 CLS.Attr · STATUS Ждёт: 2 CLS.AttrPos · SetOrder Ждёт: 2 DOM · RequestState Доступна JFP · UpdateДоступнаУ F нет связей с остальными командами этого примера. Доступны A, E и F: у них нет предшественников в этом графе. B ждёт класс; C — класс и домен; D — обе команды атрибутов.
A · E · F—Все шаги и варианты выбора текстом
- Шаг 0 · порядок ещё не составлен
Доступны A, E и F: у них нет предшественников в этом графе. B ждёт класс; C — класс и домен; D — обе команды атрибутов.
Можно поставить следующими: A · E · F / Уже стоят в очереди: — - Шаг 1 · в очередь добавлена A
Создание класса поставлено первым. Теперь B доступна. У C остаётся один предшественник — домен E. Среди доступных B, E и F следующей будет B по исходному порядку построения.
Можно поставить следующими: B · E · F / Уже стоят в очереди: A - Шаг 2 · в очередь добавлена B
Команда добавления суммы получила своё место. D всё ещё ждёт добавления статуса C. Доступны E и F; следующей по исходному порядку будет E.
Можно поставить следующими: E · F / Уже стоят в очереди: A → B - Шаг 3 · в очередь добавлена E
Домен поставлен раньше атрибута, который его использует. Теперь у C нет оставшихся предшественников. C была построена раньше независимой F и займёт следующее место.
Можно поставить следующими: C · F / Уже стоят в очереди: A → B → E - Шаг 4 · в очередь добавлена C
Обе команды атрибутов уже стоят в очереди. Можно поставить D — восстановление их порядка. Она была построена раньше F.
Можно поставить следующими: D · F / Уже стоят в очереди: A → B → E → C - Шаг 5 · в очередь добавлена D
Порядок атрибутов будет выставлен после их добавления. Осталась независимая команда F. Отсутствие ребра не означает параллельного выполнения.
Можно поставить следующими: F / Уже стоят в очереди: A → B → E → C → D - Шаг 6 · очередь готова
Получен порядок A → B → E → C → D → F. Каждая стрелка графа ведёт от более ранней команды к более поздней. Сейчас мы только составили план: в базе ничего не выполнялось.
Можно поставить следующими: — / Уже стоят в очереди: A → B → E → C → D → F
- Выбрать только D
Для D нужны обе команды атрибутов B и C. Для них нужны A и E. В запуск войдут A, B, C, D, E; независимая F не требуется. Берутся обязательные предшественники выбранной команды, затем их предшественники и так далее до конца цепочки.
- Исключить E
Без создания домена нельзя выполнить C, а без C — D. Поэтому исключение E распространяется на C и D. A, B и независимая F остаются доступными для запуска.
Если доступны несколько команд, Holkas выбирает ту, которая раньше стоит в исходном списке команд. Это делает результат устойчивым для одного и того же набора команд и связей. Например, после E становится доступна C; хотя F была доступна с самого начала, C в исходном списке раньше неё и получает следующее место.
Допустимых топологических порядков может быть несколько. Алгоритм не ищет единственную «идеальную» очередь, а соблюдает зависимости и определённое правило выбора среди доступных команд. Отсутствие ребра также не означает параллельного выполнения: при применении к базе команды выполняются последовательно.
Во время этой сортировки в базе ничего не исполняется. «Поставить команду в очередь» — построить порядок будущего применения. Реальная запись начинается только после запуска применения.
Почему связи нужны между командами
Представьте две таблицы: A ссылается внешним ключом на B, а B — на A. Если переносить каждую таблицу как неделимый блок «создать всё сразу», порядок найти трудно. На уровне команд противоречие исчезает: сначала создать таблицы, колонки и ключи, затем добавить внешние ключи.
Такой же принцип позволяет сначала создать основу объекта, затем заполнить части, а после них выполнить операции, которые требуют уже готового состава. Поэтому граф объектов и граф команд отвечают на разные вопросы.
03 / Где действительно возникает цикл
Взаимные ссылки объектов ещё не означают цикл команд
Если смотреть только на объекты
A ссылается на B, а B — на A. Для целых объектов нельзя выбрать, какой из них завершить первым.
Если разделить работу на команды
Сначала готовы обе таблицы с колонками и ключами. Затем можно добавить оба внешних ключа. Возвратных стрелок между этапами нет.
Настоящий цикл: A → B → C → A
Ни одну из этих трёх команд нельзя поставить следующей. D сама в цикл не входит, но тоже заблокирована, потому что ждёт C. В такой ситуации Holkas останавливает построение плана и сообщает об оставшихся командах и связях.
Если после обработки всех доступных вершин ещё остались команды, зависимые друг от друга по кругу, топологического порядка нет. Holkas сообщает об ошибке построения. Он не выбирает произвольную команду и не игнорирует мешающее ребро, чтобы «попробовать выполнить».
В диагностике могут оказаться и команды, которые сами не образуют цикл, но ждут его участников. Разбирать нужно связи, а не только список имён. Проверка выполняется при построении очереди, до выполнения её команд.
Если нужной команды нет в плане
Зависимость команды не всегда становится ребром между двумя вершинами. Например, команда ждёт создания домена, но домен уже есть в приёмнике и не требует изменений. Команды Create для него не будет — и это нормальная ситуация.
Holkas отдельно разбирает зависимости, для которых в наборе нет соответствующей команды. Для подтверждённой зависимости проверяется наличие её корневого объекта в плане или приёмнике. Если объекта нет и там, появляется предупреждение о непокрытой зависимости. Это не цикл: отсутствующая вершина и замкнутый круг существующих вершин — разные причины.
В интерфейсе откройте «Недостающие», чтобы увидеть список, затем нажмите «Добавить в набор и перестроить». Holkas расширит исходный набор найденными недостающими объектами и создаст новую операцию с теми же источником и приёмником. Это явное действие пользователя; сама сортировка объекты в состав не добавляет. Нужные объекты должны быть доступны в выбранном источнике. Новый план нужно проверить заново: добавленные объекты могут потребовать следующих зависимостей. Пример с атрибутом и забытым доменом — на настоящих экранах.
То же относится к объектам, которые уже совпали с приёмником. Например, форма раздела КОР в обеих базах одинакова, но процедуры её пересчёта в приёмнике нет: команды для такой формы нет и не появится, а предупреждение будет. Если в плане нет ни одной команды, операция завершается как «Завершено без изменений», но вместо сообщения о полном совпадении называет недостающие объекты и предлагает ту же кнопку. Новый план создаст только недостающее и совпавший объект не тронет. Предупреждение может говорить и о давней битой ссылке, которая к текущему переносу не относится: если объекта нет и в источнике, добавить его нельзя, и Holkas это объяснит.
На PostgreSQL ссылку объекта Паруса на процедуру закрывает и функция, и настоящая процедура (CREATE PROCEDURE) с тем же именем.
Проверка существования корня не доказывает, что любой его состав подходит произвольному коду. Отсутствие предупреждений не заменяет проверку доработки. Роли обрабатываются отдельно: предупреждение о недостающей роли требует сопоставления или подготовки роли в приёмнике, а не добавления в перенос этой кнопкой.
Подтверждённые связи и предположения по SQL
Не все зависимости имеют одинаковое основание. Часть известна из устройства метаданных или каталога СУБД. Для некоторых объектов и сохранённых версий используется разбор SQL-текста. Такой поиск способен найти похожее имя, которое на деле окажется колонкой или встроенной функцией.
Holkas отличает такие предположительные связи от подтверждённых. Если соответствующая команда присутствует, предположение может повлиять на её положение в очереди. Если цели нет, одно такое предположение не порождает предупреждение о недостающем объекте. Эти связи также не участвуют в каскадном выборе и исключении команд. Поэтому Holkas не обещает восстановить все зависимости произвольного SQL-кода.
Как граф влияет на выбор части плана
Выбор одной команды может требовать нескольких других. Для запуска нужны её обязательные предшественники, затем предшественники этих предшественников — до тех пор, пока весь путь не будет покрыт. Так выбирается вся цепочка зависимостей выбранной команды.
В графе выше переключите режим на «Выбрать только D». Порядок атрибутов D требует B и C; те требуют A и E. Получаются пять команд, хотя явно выбрана одна. Независимая F в этот выбор не входит.
Обратное действие распространяется вперёд: исключение E убирает C и далее D. A и B могут остаться, потому что домен E им не нужен. Попробуйте режим «Исключить E» на том же графе.
Оба действия работают с подтверждёнными связями уже построенного плана. Они не подгружают новые объекты из источника. И они не равнозначны обработке ошибки исполнения: после обычного отказа пропускаются оставшиеся команды того же объекта и те, что ждут упавшую по связям плана, а остальное продолжает обрабатываться. Подробнее — как применяется план.
Почему не удаляется всё лишнее
Выбранный состав означает «эти объекты должны быть в приёмнике». Он не описывает всё разрешённое содержимое базы. Посторонний отчёт не удаляется из-за отсутствия в пакете или списке.
Внутри выбранного объекта состав можно сравнить: отсутствующий в исходном методе параметр может дать Delete. Но правила различаются по типам — например, лишние колонки таблицы Holkas не удаляет. Для набора данных значимы граница отбора и правила удаления строк. Ограничения команд Delete не ограничивают SQL внутри пользовательского скрипта.
Как читать отличие
«Было» относится к приёмнику, «станет» — к содержимому источника. Красные строки diff показывают удаляемый текст, зелёные — добавляемый. План не решает, какое правило лучше: пакет с amount >= 100 предложит заменить даже более позднее правило amount >= 150, если вы выбрали этот пакет источником.
Один пакет даёт разные планы в разных базах: отсутствующую функцию нужно создать, отличающуюся — обновить, совпадающую — оставить. Поэтому сохранённый пакет или коммит не содержит универсального одобрения изменений для любого приёмника.
Что означает пустой план
Пустой план сравнения с базой означает отсутствие команд для выбранных объектов и поддерживаемых полей. Это не сравнение всей базы и не доказательство работоспособности приложения. Если указанного объекта нет в источнике, операция сообщает об отсутствии — такой результат не выдаётся за совпадение.
Пользовательский скрипт является исключением из обычного сравнения: при применении он выполняет свой SQL каждый раз, даже если остальные объекты уже совпадают.
Готовый план можно оставить без применения
Обычное сравнение читает обе стороны и сохраняет команды, различия и связи; результат можно изучить и оставить в истории. Скрипт автора с выполнением при плане уже запускает SQL в приёмнике с откатом транзакции. У такого отката есть границы, особенно для Oracle DDL и процедур Паруса. Реальный пример — сравнение базы с версией из Git.
При применении необходимые команды определяются заново. Проверка ограниченного запуска сопоставляет их по типу, действию и ключу; это не блокировка базы и не гарантия неизменности каждого просмотренного значения. Поведение при новых командах и частичном выполнении разобрано в следующей главе.
Правила конкретного приёмника
Владелец объекта и дополнительные местные права могут отличаться от разработки намеренно. На шаге «Параметры» выбирают замены владельцев и правило для лишних прав. Итог сохраняется в операции; его источник виден до запуска. Разобрать два плана с разными правилами.
Предупреждения о содержимом
План проверяет XML форм, меню и настроек вызовов методов: называет поле, место и фрагмент ошибки. Команда остаётся в плане, и решение о применении принимает человек. Исправление XML требует нового плана.
У объекта Oracle с совпавшим текстом может потребоваться Update из-за невалидности. После применения Holkas выполняет итоговую пересборку; оставшиеся невалидные объекты переносимого набора делают операцию неуспешной и дают диагностику Oracle. Нулевое число команд само по себе не подтверждает валидность.
Для форм проверяются ссылки из XML и назначения ролям/пользователям. Дополнение состава и замена роли — разные действия: недостающие зависимости и назначения форм.