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

Как это работает / 04 из 05

Манифест, пакет и Git

Манифест сохраняет состав, ZIP-пакет — содержимое объектов, Git — версии этого содержимого. От выбора зависит, какую доработку вы получите при следующем переносе.

На этой странице

Чтобы повторить выбор, сохраните манифест. Чтобы вернуться к определённому содержимому, сохраните пакет или используйте конкретный коммит Git. План для приёмника строится отдельно.

Три способа сохранить доработку

После первого переноса обычно хочется повторно использовать результат: не искать объекты заново, передать их заказчику или сохранить версию. Для этих задач нужны разные вещи.

Что сохраняетеЧто внутриКогда пригодится
МанифестТипы, имена и параметры выбора; для DAT — описание набора, для SCR — текст и условия запуска скрипта.Снова выбрать тот же состав в доступном источнике.
ZIP-пакетСодержимое выгруженных объектов, включая строки выбранного набора данных.Передать доработку в другой контур без доступа к исходной базе.
Версия в GitСодержимое объектов в файлах репозитория, закреплённое коммитом.Просмотреть изменения и выбрать определённую версию для переноса.

Ни один из этих вариантов не является готовым планом для любой базы. План появляется при сравнении содержимого с конкретным приёмником. В одной базе функцию нужно создать, в другой — обновить, а в третьей она уже совпадает. Это показано в главе о плане.

Время и сохранённое содержимое

Разработка изменилась. Что сохранилось у вас?

Функция в разработкеamount >= 100amount >= 150
При сохраненииПосле правки базыВ новом переносе

Манифест

При сохраненииИмя функции
После правки базыТот же список
В новом переносе>= 150

Содержимое читается из выбранного источника заново. В этом примере источник — текущая разработка.

ZIP-пакет

При сохраненииКод с >= 100
После правки базыТот же файл
В новом переносе>= 100

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

Коммит Git

При сохраненииКод с >= 100
После правки базыКоммит сохранён
В новом переносе>= 100

Конкретный коммит закрепляет содержимое. Новые коммиты ветки не меняют выбранную старую версию.

Условное продолжение учебной функции. Сначала сохранено правило 100, затем разработка изменена до 150. В строке Git выбран прежний коммит, а не текущее состояние ветки.

Манифест отвечает на вопрос «что выбрать»

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

Имя манифеста относится к составу, а не к телу функции или содержимому класса. Отдельной версии у манифеста нет; номер релиза можно написать в имени. Если база изменилась, прежний манифест может привести к новому плану. Для набора данных он хранит описание отбора, но не выбранные строки. Скрипт автора — исключение: его SQL и условия запуска хранятся в самом составе.

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

Пакет отвечает на вопрос «что передать»

При выгрузке в ZIP Holkas сохраняет выбранные объекты целиком. Это не набор только тех отличий, которые вы видели при сравнении с другой базой. Получатель читает пакет целиком: состав уже определён при выгрузке.

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

Пакеты можно хранить и в S3-совместимом хранилище. Оно служит местом доставки файла, а правила сравнения с базой остаются теми же. Весь путь показан в передаче доработки ZIP-пакетом.

Git отвечает на вопрос «какую версию взять»

Выгрузка в Git сохраняет объекты в репозитории. История коммитов помогает увидеть, что менялось между версиями. При чтении из Git можно выбрать нужные объекты, как при чтении из базы.

Для повторения определённого состояния проверяйте конкретный коммит: ветка может продвинуться. Старый коммит можно сравнить с базой, но применение будет обычным новым переносом — с планом и текущим состоянием приёмника. Это не автоматический откат прошлой операции и не восстановление всей базы.

В учебном примере с Git сохранены две версии функции: amount > 0 и amount >= 100. Там видны и коммиты в GitHub, и результат сравнения выбранной версии с базой.

Когда промежуточное сохранение не нужно

Если обе базы доступны одному Holkas, можно сравнить и перенести выбранные объекты напрямую. Манифест, пакет и Git не являются обязательными этапами. Они нужны, когда вы хотите повторить состав, передать содержимое или зафиксировать версию.

Что важно при смене СУБД

Маршрут не отменяет ограничений типов: объекты Паруса поддерживают перенос между Oracle и PostgreSQL, а объекты самой базы остаются привязаны к своей СУБД. Подробнее — что переносится.

SQL-файл — отдельный результат

Экспорт в SQL готовит текст команд для поддерживаемых объектов базы соответствующей СУБД. Логические объекты Паруса этим способом не переносятся. Выполнение файла — отдельное действие; сам экспорт не применяет его к базе и не переводит код между диалектами SQL. Файл записывается в том же порядке команд, что и перенос в пустую базу: триггер — после своей функции, внешний ключ — после таблицы, на которую ссылается, права — после своего объекта. Файл Oracle, как и перенос в базу, заканчивается пересборкой затронутых схем.

У функций и процедур PostgreSQL владелец и права назначаются каждому варианту с разными аргументами. Если источник не даёт EXECUTE для PUBLIC, выгрузка снимает автоматическое право PostgreSQL.

В практической главе о SQL-файле можно прочитать и скачать настоящий результат выгрузки. Там показаны самостоятельное выполнение файла через psql, проверка вызова функции и пустое повторное сравнение. Для передачи доработки с планом у получателя используйте ZIP-пакет.

Точное устройство файлов: пакет доработок, манифест состава, описание набора данных.