Как это работает / 04 из 05
Манифест, пакет и Git
Манифест сохраняет состав, ZIP-пакет — содержимое объектов, Git — версии этого содержимого. От выбора зависит, какую доработку вы получите при следующем переносе.
На этой странице
Чтобы повторить выбор, сохраните манифест. Чтобы вернуться к определённому содержимому, сохраните пакет или используйте конкретный коммит Git. План для приёмника строится отдельно.
Три способа сохранить доработку
После первого переноса обычно хочется повторно использовать результат: не искать объекты заново, передать их заказчику или сохранить версию. Для этих задач нужны разные вещи.
| Что сохраняете | Что внутри | Когда пригодится |
|---|---|---|
| Манифест | Типы, имена и параметры выбора; для DAT — описание набора, для SCR — текст и условия запуска скрипта. | Снова выбрать тот же состав в доступном источнике. |
| ZIP-пакет | Содержимое выгруженных объектов, включая строки выбранного набора данных. | Передать доработку в другой контур без доступа к исходной базе. |
| Версия в Git | Содержимое объектов в файлах репозитория, закреплённое коммитом. | Просмотреть изменения и выбрать определённую версию для переноса. |
Ни один из этих вариантов не является готовым планом для любой базы. План появляется при сравнении содержимого с конкретным приёмником. В одной базе функцию нужно создать, в другой — обновить, а в третьей она уже совпадает. Это показано в главе о плане.
Время и сохранённое содержимое
Разработка изменилась. Что сохранилось у вас?
amount >= 100amount >= 150Манифест
>= 150Содержимое читается из выбранного источника заново. В этом примере источник — текущая разработка.
ZIP-пакет
>= 100Пакет содержит прежний снимок объектов. Для его чтения исходная база больше не нужна.
Коммит Git
>= 100Конкретный коммит закрепляет содержимое. Новые коммиты ветки не меняют выбранную старую версию.
Манифест отвечает на вопрос «что выбрать»
Сохранённый манифест удобно раскрыть против выбранного источника, проверить наличие объектов и добавить нужные позиции в перенос. Подключения источника и приёмника выбираются при запуске; сам файл не даёт доступа к базам.
Имя манифеста относится к составу, а не к телу функции или содержимому класса. Отдельной версии у манифеста нет; номер релиза можно написать в имени. Если база изменилась, прежний манифест может привести к новому плану. Для набора данных он хранит описание отбора, но не выбранные строки. Скрипт автора — исключение: его 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-пакет.
Точное устройство файлов: пакет доработок, манифест состава, описание набора данных.