Задача / по шагам
Сравнить базу с сохранённой версией доработки
Найдите отличие от версии в Git, разберите diff кода и сохраните результат проверки. Пошаговый пример без применения изменений к базе.
На этой странице
- 01Версия в Git
Конкретный коммит
- 02База
Текущее состояние функции
- 03План и diff
Разобраться в отличии
Пример выполнен на тестовом PostgreSQL. В учебной приёмке вручную изменили одну функцию; Holkas сравнил её с коммитом из открытого репозитория Holkas-Example. План оставлен без применения.
Учебный пример
После поставки доработку иногда поправляют прямо в базе. Перед следующим переносом полезно понять, совпадает ли она с сохранённой версией и что именно изменилось.
Исходное состояние: в Git-репозитории сохранена функция проверки суммы версии 1.2, принимающая сумму от 100 — как её туда сохранили. В учебной приёмке вручную подняли порог до 150. Найдём это отличие и оставим план для обсуждения, сохранив код базы без изменений со стороны Holkas.
Проверяемый объект
parus.f_hksite_contract_check — функция проверки суммы учебного договора.
Сохранённая версия 1.2
В коммите b0e9abb8 функция принимает сумму от 100.
Ручное изменение в базе
В приёмке порог подняли до 150. Сумма 125 теперь не проходит проверку.
Перед началом
- 01
Версия для сверки
Нужен Git-репозиторий с ранее сохранёнными через Holkas объектами. Как получить такую историю — в примере с двумя версиями. Для проверки конкретной поставки возьмите её коммит.
- 02
Чтение обеих сторон
Для построения плана нужны права на чтение Git-подключения и базы-приёмника. Для применения понадобится запись в приёмник; в этой задаче мы ограничимся сравнением. Как настроить права.
- 03
Понятная граница проверки
Выберите объекты доработки или используйте сохранённый манифест. Здесь сравниваем одну функцию. Остальные объекты базы и строки документов в эту проверку не входят.
Зафиксируйте версию источника
Откройте «Перенести» и выберите источником «Учебная · GitHub». На вкладке «Коммит» выберите b0e9abb8 — версию 1.2 из нашего примера — и нажмите «Выбрать @ b0e9abb8». Полный SHA можно сверить в GitHub.
Ветка main может получить новые коммиты. Выбранный SHA задаёт конкретное состояние, с которым вы сравниваете базу. В своём репозитории используйте коммит нужной поставки.
Выберите базу и состав проверки
Приёмником укажите «Учебная · приёмка». Найдите parus.f_hksite_contract_check, отметьте функцию и откройте «Выбранные». Запишите основание проверки — оно поможет найти результат в истории. Перейдите на шаг «Параметры», проверьте правила сравнения с приёмником и нажмите «Запустить план».
Направление Git → база задаёт смысл будущих команд. Источник содержит образец, приёмник — состояние, которое с ним сравнивают. Запуск плана ещё не выполняет эти команды в базе.
Посмотрите, какое отличие найдено
Дождитесь статуса «План готов». В нашем примере получилась одна команда Update для тела функции. Откройте строку команды, затем «Diff исходного кода».
Если план пустой
Для выбранного состава Holkas не нашёл команд переноса. Проверьте источник и список объектов, прежде чем делать вывод о совпадении всей доработки.
Если команд больше, чем ожидали
Разберите каждую команду и её объект. Отличия могут касаться нескольких частей выбранного объекта; число объектов и число команд не обязаны совпадать.
Update означает, что для приведения приёмника к выбранному источнику функцию нужно изменить. Само наличие команды не говорит, какая версия правильная для вашей задачи.
Прочитайте diff в направлении переноса
В окне diff нажмите «Все строки», чтобы видеть условие вместе с телом функции. Красные строки с минусом показывают код приёмника, который план предлагает убрать; зелёные с плюсом — код из источника, который предлагает добавить.
Ручная правка оказалась нужной
Согласуйте её и сохраните принятую версию доработки в Git отдельным коммитом. После этого можно проверять базы уже относительно новой версии.
Нужна сохранённая версия
Согласуйте возврат к ней, подготовьте базу к изменению и постройте свежий план перед применением. Что проверить перед записью.
Здесь diff показывает переход от 150 к 100. Это предполагаемый результат применения Git → база. Чтобы установить, кто и зачем поднял порог, потребуется история задачи или журнал самой базы.
Оставьте результат проверки в истории
Закройте diff и перейдите в «Операции», не нажимая «Применить». Найдите операцию по ID или основанию. В нашем примере e3a2dbe10ae6 остаётся в статусе «План готов» — сравнение сохранено, команда не выполнена. Ссылку на операцию можно передать коллеге с нужными правами.
Мы проверили функцию до и после сравнения — сумма 125 по-прежнему не проходила условие >= 150. План не поменял код в приёмке. Если к разбору вернулись позже, постройте новое сравнение через «Повторить с изменениями».
Версия определена
Сравнение привязано к конкретному коммиту Git.
Отличие разобрано
Порог в базе — 150, в сохранённой версии — 100.
Применение не запущено
Результат остался в истории для обсуждения.
Если что-то пошло не так
Хочу сравнить две базы без Git
Выберите базу с нужной версией источником, проверяемую базу — приёмником. Выбор объектов и разбор плана те же. Это показано в первом переносе; для сравнения остановитесь перед применением.
Отличия есть, но я не знаю, какая версия правильная
План объясняет необходимое изменение приёмника относительно источника. Он не определяет бизнес-смысл ручной правки. Сопоставьте код с задачей и согласуйте решение с ответственным за доработку.
Можно ли по этому плану узнать автора ручной правки?
Нет. Это сравнение двух состояний. Аудит Holkas показывает действия внутри Holkas; изменение функции внешним SQL-клиентом ищут в журналах базы или в истории работы команды.
В истории найден старый план — он ещё актуален?
Он описывает состояние на момент проверки. База могла измениться позже. Откройте «Повторить с изменениями», проверьте маршрут и состав и запустите новый план. Старую операцию используйте как свидетельство прежнего сравнения.