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

Задача / по шагам

Сравнить базу с сохранённой версией доработки

Найдите отличие от версии в Git, разберите diff кода и сохраните результат проверки. Пошаговый пример без применения изменений к базе.

На этой странице
  1. 01
    Версия в Git

    Конкретный коммит

  2. 02
    База

    Текущее состояние функции

  3. 03
    План и diff

    Разобраться в отличии

Пример выполнен на тестовом PostgreSQL. В учебной приёмке вручную изменили одну функцию; Holkas сравнил её с коммитом из открытого репозитория Holkas-Example. План оставлен без применения.

Учебный пример

После поставки доработку иногда поправляют прямо в базе. Перед следующим переносом полезно понять, совпадает ли она с сохранённой версией и что именно изменилось.

Исходное состояние: в Git-репозитории сохранена функция проверки суммы версии 1.2, принимающая сумму от 100 — как её туда сохранили. В учебной приёмке вручную подняли порог до 150. Найдём это отличие и оставим план для обсуждения, сохранив код базы без изменений со стороны Holkas.

JFP

Проверяемый объект

parus.f_hksite_contract_check — функция проверки суммы учебного договора.

≥ 100

Сохранённая версия 1.2

В коммите b0e9abb8 функция принимает сумму от 100.

≥ 150

Ручное изменение в базе

В приёмке порог подняли до 150. Сумма 125 теперь не проходит проверку.

Перед началом

  • 01

    Версия для сверки

    Нужен Git-репозиторий с ранее сохранёнными через Holkas объектами. Как получить такую историю — в примере с двумя версиями. Для проверки конкретной поставки возьмите её коммит.

  • 02

    Чтение обеих сторон

    Для построения плана нужны права на чтение Git-подключения и базы-приёмника. Для применения понадобится запись в приёмник; в этой задаче мы ограничимся сравнением. Как настроить права.

  • 03

    Понятная граница проверки

    Выберите объекты доработки или используйте сохранённый манифест. Здесь сравниваем одну функцию. Остальные объекты базы и строки документов в эту проверку не входят.

Зафиксируйте версию источника

Откройте «Перенести» и выберите источником «Учебная · GitHub». На вкладке «Коммит» выберите b0e9abb8 — версию 1.2 из нашего примера — и нажмите «Выбрать @ b0e9abb8». Полный SHA можно сверить в GitHub.

В Holkas выбран коммит b0e9abb8 учебного Git-репозитория
Источник проверки — сохранённая версия 1.2 с порогом суммы 100.

Ветка main может получить новые коммиты. Выбранный SHA задаёт конкретное состояние, с которым вы сравниваете базу. В своём репозитории используйте коммит нужной поставки.

Выберите базу и состав проверки

Приёмником укажите «Учебная · приёмка». Найдите parus.f_hksite_contract_check, отметьте функцию и откройте «Выбранные». Запишите основание проверки — оно поможет найти результат в истории. Перейдите на шаг «Параметры», проверьте правила сравнения с приёмником и нажмите «Запустить план».

Маршрут из конкретного коммита Git в учебную приёмку, одна выбранная функция и основание проверки
Проверяем только учебную функцию. После выбора объектов перейдите к параметрам; запуск плана выполняет чтение и сравнение.

Направление Git → база задаёт смысл будущих команд. Источник содержит образец, приёмник — состояние, которое с ним сравнивают. Запуск плана ещё не выполняет эти команды в базе.

Посмотрите, какое отличие найдено

Дождитесь статуса «План готов». В нашем примере получилась одна команда Update для тела функции. Откройте строку команды, затем «Diff исходного кода».

Готовый план e3a2dbe10ae6 содержит одну неприменённую команду Update функции
Одна команда Update, без Create и Delete. Кнопка «Применить» доступна этому пользователю, но для сравнения она не нужна.

Если план пустой

Для выбранного состава Holkas не нашёл команд переноса. Проверьте источник и список объектов, прежде чем делать вывод о совпадении всей доработки.

Если команд больше, чем ожидали

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

Update означает, что для приведения приёмника к выбранному источнику функцию нужно изменить. Само наличие команды не говорит, какая версия правильная для вашей задачи.

Прочитайте diff в направлении переноса

В окне diff нажмите «Все строки», чтобы видеть условие вместе с телом функции. Красные строки с минусом показывают код приёмника, который план предлагает убрать; зелёные с плюсом — код из источника, который предлагает добавить.

Diff функции — красные строки с условием amount >= 150 и зелёные с amount >= 100
Изменились комментарий и условие: две удаляемые и две добавляемые строки. Код приёмника пока остаётся прежним.

Ручная правка оказалась нужной

Согласуйте её и сохраните принятую версию доработки в Git отдельным коммитом. После этого можно проверять базы уже относительно новой версии.

Нужна сохранённая версия

Согласуйте возврат к ней, подготовьте базу к изменению и постройте свежий план перед применением. Что проверить перед записью.

Здесь diff показывает переход от 150 к 100. Это предполагаемый результат применения Git → база. Чтобы установить, кто и зачем поднял порог, потребуется история задачи или журнал самой базы.

Оставьте результат проверки в истории

Закройте diff и перейдите в «Операции», не нажимая «Применить». Найдите операцию по ID или основанию. В нашем примере e3a2dbe10ae6 остаётся в статусе «План готов» — сравнение сохранено, команда не выполнена. Ссылку на операцию можно передать коллеге с нужными правами.

Операция сравнения найдена в истории и имеет статус «План готов»
Сохранены направление, основание, автор проверки и одна подготовленная команда. Это результат сравнения на момент построения плана.

Мы проверили функцию до и после сравнения — сумма 125 по-прежнему не проходила условие >= 150. План не поменял код в приёмке. Если к разбору вернулись позже, постройте новое сравнение через «Повторить с изменениями».

Версия определена

Сравнение привязано к конкретному коммиту Git.

Отличие разобрано

Порог в базе — 150, в сохранённой версии — 100.

Применение не запущено

Результат остался в истории для обсуждения.

Если что-то пошло не так

Хочу сравнить две базы без Git

Выберите базу с нужной версией источником, проверяемую базу — приёмником. Выбор объектов и разбор плана те же. Это показано в первом переносе; для сравнения остановитесь перед применением.

Отличия есть, но я не знаю, какая версия правильная

План объясняет необходимое изменение приёмника относительно источника. Он не определяет бизнес-смысл ручной правки. Сопоставьте код с задачей и согласуйте решение с ответственным за доработку.

Можно ли по этому плану узнать автора ручной правки?

Нет. Это сравнение двух состояний. Аудит Holkas показывает действия внутри Holkas; изменение функции внешним SQL-клиентом ищут в журналах базы или в истории работы команды.

В истории найден старый план — он ещё актуален?

Он описывает состояние на момент проверки. База могла измениться позже. Откройте «Повторить с изменениями», проверьте маршрут и состав и запустите новый план. Старую операцию используйте как свидетельство прежнего сравнения.