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

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

Перенести доработку КОР Парус 8 между базами

Первый перенос доработки из одной базы Паруса в другую: с тестовой на рабочую (с теста на прод), из разработки в приёмку, между двумя рабочими. Или только сравнение двух баз, без применения. Один пример на настоящих экранах Holkas — от выбора объектов до проверки результата.

На этой странице
  1. 01
    Разработка

    Доработка уже готова

  2. 02
    План изменений

    Сравниваем и разбираем

  3. 03
    Приёмка

    Применяем и проверяем

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

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

На разработке подготовили изменения для учебного класса договоров: расширили название, добавили колонку комментария, создали метод и изменили проверку суммы. В приёмке осталась прежняя версия. Перенесём эту разницу и проверим результат.

Обе базы — PostgreSQL с Парусом. Для переноса между Oracle и PostgreSQL действуют отдельные ограничения объектов базы.

CLS

Класс договоров

HolkasSiteContracts — подпись и домен атрибута, новый метод проверки суммы.

TBP

Таблица договоров

parus.hksite_contracts — более длинное название и новая колонка комментария.

JFP

Функция проверки

parus.f_hksite_contract_check — договор с нулевой суммой больше не проходит проверку.

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

  • 01

    Две доступные базы

    Holkas установлен, есть доступ к источнику и приёмнику. Для первого знакомства используйте учебные базы или копии. Установить Holkas.

  • 02

    Известный состав доработки

    В нашем примере это класс, таблица и функция. У вашей доработки состав будет своим — связанные объекты нужно включить явно.

  • 03

    Возможность восстановиться

    Перед переносом в рабочую базу подготовьте резервную копию и согласуйте время работ. По умолчанию общего отката нет. Для PostgreSQL можно выбрать одну транзакцию.

Подготовьте подключения

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

Два учебных подключения — разработка и приёмка, с разными портами и метками среды
«Учебная · разработка» содержит новую версию; «Учебная · приёмка» — прежнюю. В рабочем сценарии так же различайте тестовую и рабочую базы.

Успешная проверка связи не гарантирует права на все команды. Учётной записи приёмника понадобятся права на выбранные изменения.

Задайте направление и выберите объекты

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

Третий шаг переноса с выбранными классом, таблицей и функцией
Три объекта в исходном наборе. Их состав сохранится в операции, даже если для какого-то объекта изменений не окажется.

Выбор класса включает его дочерние объекты. Таблица и функция — отдельные объекты: в этом примере мы выбираем их явно. Сверьте имена и адреса обоих подключений.

Постройте и разберите план

Перейдите на шаг «Параметры». Проверьте правила сравнения с приёмником и нажмите «Запустить план». Как работают владельцы и права. На вкладке «План» появятся конкретные команды. В нашем примере их шесть — выбранный класс раскрывается вместе с дочерними объектами.

Готовый план из шести команд, включая Update функции и Create метода класса
2 Create: колонка и метод. 3 Update: атрибут, колонка и функция. 1 SetOrder: порядок атрибутов класса. Показан сохранённый план завершённой операции.

Прочитайте действия

Create добавляет объект или его часть, Update меняет существующее, SetOrder задаёт порядок. Delete требует особенно внимательной проверки.

Откройте нужную команду

Детали показывают поля «было / станет», тело объекта, SQL и зависимости — доступность разделов зависит от типа команды.

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

Можно исключить ненужное или перейти к режиму «Только выбранные команды». Учитывайте обязательные зависимости.

Нужно только сравнить две базы — остановитесь здесь. План построен, в приёмнике ничего не изменилось; результат сравнения остаётся в истории операций. Исключение — скрипт автора с выполнением при плане: он запускается в приёмнике уже на этой стадии — правила и границы отката. Если Holkas сообщает о недостающих объектах, дополните набор и перестройте план.

Разберите изменение объекта Паруса

Откройте команду Update для атрибута HolkasSiteContracts|NAME. Здесь Holkas сравнивает свойства атрибута класса: в поле «Наименование» подпись «Название» заменяется на «Наименование договора», в поле «Домен» — TSTR0020 на TSTR0040. Красным выделено прежнее значение в приёмнике, зелёным — новое из источника.

Сравнение свойств атрибута NAME класса HolkasSiteContracts — изменены наименование и домен, остальные показанные поля совпадают
Одна из трёх команд Update в нашем плане. Заголовки «Было / Станет» задают направление сравнения, цвет выделяет изменённые свойства. Кадр снят из сохранённого сравнения после завершения операции.

Имя атрибута NAME сохраняется — меняется его подпись. Позиция остаётся равной 2. Эта команда меняет метаданные Паруса; изменение физической колонки таблицы показано отдельной командой в том же плане. Состав и правила переноса класса.

Посмотрите, что меняется в функции

Откройте строку Update для parus.f_hksite_contract_check, затем нажмите «Diff исходного кода». Раньше функция принимала сумму, равную нулю; теперь требует положительную сумму.

Diff функции — amount >= 0 заменяется на amount > 0 вместе с поясняющим комментарием
Одно небольшое изменение с понятным смыслом. Скриншот можно увеличить и прочитать код в исходном масштабе.

Красные строки — прежний текст, зелёные — новый. Режим «Все строки» позволяет увидеть контекст вокруг изменения. Это сравнение текста; правильность бизнес-логики проверяется отдельно.

Примените проверенный план

Ещё раз проверьте приёмник, состав команд и предупреждения. Нажмите «Применить». Дождитесь завершения — ход операции и исходы команд появятся на той же странице. Подробности доступны в «Логе».

Успешно завершённый перенос, все шесть команд отмечены как исполненные
Все шесть команд учебного примера исполнены. При ошибке часть изменений уже могла примениться — сначала разберите журнал и исходы команд.

Если после построения плана базу меняли, постройте новый план. При полном запуске возможны новые команды «вне плана»; при ограниченном запуске появление новых команд останавливает применение до записи. Подробнее о контроле.

Проверьте результат повторным сравнением

Нажмите «Повторить с изменениями». Holkas откроет новый перенос с теми же подключениями и исходным набором. Постройте план ещё раз. В нашем примере он пустой — перенос больше не требуется.

Повторное сравнение учебных объектов завершено без изменений
Дополнительно мы сверили колонки таблицы, атрибуты, метод и результаты функции прямыми запросами к обеим учебным базам — они совпали.

Пустой план относится только к выбранным объектам и поддерживаемым правилам сравнения. После реального переноса проверьте работу доработки в Парусе на согласованном примере.

Команды исполнены

Нет необъяснённых ошибок и пропусков; журнал просмотрен.

Отличия проверены

Повторный план не содержит неожиданных изменений.

Доработка проверена

В рабочем сценарии результат подтверждают в самом Парусе.

Отдельный пример · до применения

Если забыли связанный объект

Рассмотрим ещё одну доработку того же класса: в источнике атрибут NAME теперь использует новый строковый домен HKSITE_NAME40 длиной 40 символов. В приёмнике этого домена нет. Намеренно выберем для переноса только класс HolkasSiteContracts — без таблицы, функции и самого домена. Так увидим, как Holkas помогает дополнить неполный состав.

Атрибут выбранного классаHolkasSiteContracts|NAME

Входит в перенос вместе с классом.

использует
Недостающий домен · DOMHKSITE_NAME40

Есть в источнике, но не выбран. В приёмнике отсутствует.

  1. 1. Откройте список недостающих

    План построится, но над командами появится предупреждение. Нажмите «Недостающие»: здесь Holkas перечислит объекты, которых не нашёл ни в плане, ни в приёмнике. В нашем примере одна команда изменения атрибута ждёт один домен — HKSITE_NAME40. Пока его нечем создать.

    План из двух команд с предупреждением и раскрытым списком, где указан недостающий домен HKSITE_NAME40
    В исходном наборе один класс. В плане — Update атрибута и SetOrder порядка атрибутов. Жёлтое предупреждение объясняет, почему этого недостаточно для применения.
  2. 2. Дополните набор одной кнопкой

    Нажмите «Добавить в набор и перестроить». Holkas добавит найденные недостающие объекты к исходному составу и создаст новую операцию с теми же источником и приёмником. Объекты будут прочитаны из источника заново. Это построение нового плана; записи в приёмник ещё нет. Если нужного объекта нет в выбранном источнике или версии, сначала подготовьте его там либо отдельно в приёмнике.

  3. 3. Проверьте новый план

    Теперь в наборе два объекта, а в плане три команды. Первой стоит Create домена HKSITE_NAME40, затем Update атрибута и SetOrder порядка атрибутов класса. Предупреждение исчезло. Откройте добавленную команду, проверьте свойства домена и заново определите состав запуска: прежние исключения команд не сохраняются. Если обнаружились следующие недостающие объекты, разберите их и повторите перестроение.

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

Дальше с этой доработкой

Сохраните состав в манифесте

На шаге выбора объектов нажмите «Сохранить как манифест». Дайте составу имя и выберите, кому он виден. В следующий раз откройте вкладку «Манифест» при выборе объектов. Он хранит список того, что переносить; сами объекты читаются из источника заново.

Манифест учебной доработки с классом, таблицей, функцией и набором статусов
Здесь состав уже дополнен набором данных из следующего примера. Манифест можно скачать и передать файлом.
Сохранить и повторно использовать манифест →

Добавьте справочник решения

В карточке манифеста добавьте «Набор данных». Выберите учебную базу и корневую таблицу EXTRA_DICTS. Holkas построит схему с частью EXTRA_DICTS_VALUES. В границе «Список ключей» укажите HKSITE_STATUS, нажмите «Проверить», затем «Строки» — в отборе должен быть только учебный словарь. Сохраните набор в манифест и включите его в следующий перенос.

Словарь и его значения в конструкторе набора, граница ограничена ключом HKSITE_STATUS
Учебный справочник содержит статусы «Черновик», «На согласовании», «Согласован». Его перенос завершился успешно, повторный план пустой. Конструктор читает структуру из базы; нужные строки справочника должны уже существовать в источнике.
Пройти перенос справочника по шагам →

Пустой план тоже требует внимания

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

Предупреждение о функции у совпавшей формы
Holkas предлагает дополнить состав даже при нуле команд.
Разобрать проверенный пример →

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

В плане появились неожиданные изменения

Проверьте направление и состав выбора. Внутри выбранного объекта могут удаляться части, если это разрешает его тип; объекты вне набора не удаляются просто из-за отсутствия в источнике. Правила объектов.

Не хватает связанного объекта

В предупреждении откройте «Недостающие» и проверьте список. Кнопка «Добавить в набор и перестроить» расширит состав и создаст новый план — его нужно проверить до применения. Пример с забытым доменом. Holkas предупреждает об известных ему подтверждённых связях и не гарантирует обнаружение всех зависимостей.

Одна из команд завершилась ошибкой

Часть изменений уже могла примениться. При обычной ошибке пропускаются оставшиеся команды этого объекта и всё, что ждёт упавшую команду, а остальное продолжается. Инфраструктурный сбой может оборвать весь запуск. В обычном режиме общего отката нет — сначала изучите журнал. Поведение одной транзакции PostgreSQL отличается. Поведение при ошибках. Разбор частичного переноса по шагам.

План пустой, а ожидаемый результат не получен

Проверьте выбор объектов и правила их сравнения. Пустой план относится только к выбранному составу и переносимым свойствам. Например, у последовательности текущее выданное число не сравнивается. Что переносит последовательность.