Задача / по шагам
Передать доработку Паруса через ZIP-пакет
Когда базы находятся в разных контурах: выгрузить выбранную доработку, передать файл и построить план уже на стороне получателя. Пять шагов на настоящих экранах.
На этой странице
- 01Разработка
Выбираем состав
- 02ZIP-пакет
Передаём снимок
- 03Приёмка
Сравниваем и применяем
Учебный пример на PostgreSQL. Чтобы проверить весь путь, мы скачали и заново загрузили ZIP в тот же тестовый Holkas. Два независимых закрытых контура здесь не разворачивались.
Учебный пример
Когда прямого доступа к базе заказчика нет, доработку можно передать отдельным файлом. На стороне разработки Holkas собирает ZIP; на стороне получателя этот ZIP становится источником нового переноса.
Исходное состояние: в разработке лежит учебная доработка договоров версии 1.1 — класс, таблица и функция. В приёмке класс и таблица такие же, а функция прежняя: сумма может быть равна нулю. Сохраним версию 1.1 в файл, доставим её в приёмку и проверим результат.
Устройство архива, оглавление и скачиваемый учебный ZIP — в справочнике Пакет доработок.
На шаге «Параметры» можно записать в ZIP обязательное требование полной установки одной транзакцией PostgreSQL. Пример и ограничения.
Класс договоров
HolkasSiteContracts и его дочерние объекты.
Таблица договоров
parus.hksite_contracts — структура учебной таблицы.
Проверка суммы
parus.f_hksite_contract_check — правило версии 1.1: сумма больше нуля.
Перед началом
- 01
Holkas с обеих сторон
В исходном контуре нужен доступ на чтение базы, у получателя — Holkas с доступом к его базе. Подключения к одной сети не требуется.
- 02
Понятный состав
Возьмите состав из первого переноса или своего манифеста. Пакет содержит выбранные объекты, а не копию всей базы.
- 03
Подготовленная приёмка
Проверьте совместимость объектов и права на изменения. Перед рабочим переносом подготовьте резервную копию.
Выберите базу и файл назначения
В разделе «Перенести» выберите базу источником, «Файл пакета» — приёмником. Задайте имя contracts-1.1.zip. На шаге «Объекты» выберите класс, таблицу и функцию, заполните основание и перейдите на шаг «Параметры». Для обычной выгрузки оставьте «Перенести одной транзакцией» по умолчанию, затем нажмите «Выгрузить пакет».
Для ZIP не строится план отличий: у файла нет состояния базы, с которым можно сравнить доработку. Выгружаются текущие версии выбранных объектов.
Скачайте и передайте пакет
Дождитесь завершения. Кнопка «Скачать contracts-1.1.zip» выдаёт результат операции. Передайте файл получателю согласованным способом и сообщите, для какой доработки и версии он подготовлен.
ZIP хранит снимок объектов на момент выгрузки. Последующие правки исходной базы в этот файл не попадут; для новой версии нужна новая выгрузка.
Загрузите ZIP у получателя
В Holkas получателя откройте новый перенос. Источником выберите «Файл пакета» и загрузите полученный ZIP. Нажмите «Выбрать», затем укажите базу назначения.
Пакет читается целиком — повторного выбора объектов в нём нет. Проверьте имя файла, приёмник и организацию. Выбор отдельных команд возможен позже, в плане.
Разберите план для этой базы
Нажмите «Запустить план». В нашей приёмке класс и таблица уже совпадают с пакетом, а функция ещё принимает нулевую сумму. Поэтому план содержит одну команду Update. Откройте её и проверьте diff.
Один пакет может дать разные планы для разных баз. Не переносите выводы из чужого плана на свою приёмку. После проверки нажмите «Применить» и дождитесь результата.
Повторите сравнение с тем же файлом
Создайте ещё один перенос: снова загрузите тот же contracts-1.1.zip и выберите ту же приёмку. Постройте план. В нашем прогоне он пустой: функция, класс и таблица больше не требуют переноса.
Для новой операции файл загружается заново. Пустой план подтверждает совпадение выбранного состава по правилам Holkas; работу доработки проверьте отдельно в Парусе.
Файл получен
У получателя есть нужная версия ZIP.
План исполнен
Разобраны исходы команд и журнал.
Результат проверен
Повторное сравнение и проверка в Парусе.
Если что-то пошло не так
После выгрузки источник изменился
Пакет не обновляется сам. Выгрузите новую версию и сообщите получателю, какой файл использовать.
Нужен только один объект из большого пакета
Вернитесь к источнику и соберите пакет нужного состава либо внимательно ограничьте команды готового плана с учётом зависимостей. Пакет не является резервной копией всей базы.
У получателя другая СУБД
Логические объекты Паруса поддерживают перенос между Oracle и PostgreSQL, но SQL функции из этого примера автоматически не переводится. См. ограничения маршрутов.