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

Что нового

v0.1.35

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

Что сделать после обновления.

  • PostgreSQL: объект без владельца (Owner пропущен или пуст) больше не переносится. Это касается таблиц TBP, последовательностей SQP, представлений JVP, функций JFP, процедур JPP и составных типов CTP. План не строится, а сообщение называет такие объекты. Раньше Holkas подставлял роль схемы или предлагал изменение, которое не проходило. Укажите владельца в файле или выгрузите объект заново.
  • PostgreSQL: пакеты и снимки Git с составными типами CTP, снятые прежними версиями, у типов без явных прав хранят пустой список прав. Теперь он означает «права USAGE нет ни у кого», и план предложит отозвать его у PUBLIC и владельца. Перед переносом выгрузите такие типы заново из исходной базы.
  • Если вы переносили составные типы, последовательности или таблицы PostgreSQL прежними версиями, постройте план заново из того же источника. Теперь он покажет расхождения, и применение исправит приёмник.

Незаметные расхождения при переносе в PostgreSQL.

  • Последовательность SQP сохраняет тип числа: smallint, integer или bigint. Раньше integer в источнике молча становился bigint в приёмнике. А если в приёмнике уже был integer, перенос предела больше его диапазона падал. Если пакет записан прежней версией и типа не содержит, Holkas оставляет тип приёмника и предупреждает об этом в плане.
  • Составной тип CTP, закрытый в источнике от PUBLIC, закрыт в приёмнике уже после первого переноса. Раньше PostgreSQL выдавал PUBLIC право USAGE при создании типа, и Holkas этого не замечал. SQL-файл тоже содержит REVOKE.
  • Поле составного типа CTP сохраняет явное правило сортировки, например COLLATE "C". Раньше поле получало правило базы-приёмника.
  • Отрицательный масштаб numeric в PostgreSQL 15 и новее, например numeric(12,-2), читается верно у полей CTP и колонок TBP. Раньше он читался как 2046.
  • Таблица TBP и составной тип CTP получают своего владельца при создании, под какой бы ролью ни работало подключение. Раньше они доставались роли подключения, и только следующий план предлагал сменить владельца.
  • PostgreSQL не умеет переставлять поля существующего составного типа. Если порядок полей источника в приёмнике не получить, перенос этого типа отказывает. Например, поля поменялись местами или новое поле вставлено в середину. Раньше новое поле молча вставало в конец, и функции, которые работают с полями по их порядку, вели себя в двух базах по-разному. Теперь в плане есть предупреждение с обоими порядками. Тип не меняется, а функции и процедуры набора, которые его ждут, пропускаются.

Изменения, которые повторялись в каждом плане.

  • PostgreSQL: тип numeric(12) без масштаба и char без длины, записанные в файле вручную, совпадают с тем, что читается из базы. Раньше каждый план предлагал изменить такое поле CTP или колонку TBP. Однобайтовый системный тип "char" больше не пишется как char(1).
  • Oracle: имя ссылки на базу данных у синонима JSY сравнивается без учёта регистра, как в самом Oracle. Раньше файл с archive.world давал изменение после каждого переноса.
  • Связь LNK, у которой порядок пар атрибутов не совпадает с порядком их имён, получает нужный порядок. Раньше Парус сдвигал пары при каждой вставке, и план каждый раз предлагал их переставить. В плане появилась команда «Порядок атрибутов связи».

Ошибки при применении.

  • Параметр действия ACT, у которого сменился или очищен атрибут связи, освобождает прежний атрибут до его удаления. Раньше удаление атрибута падало с нарушением внешнего ключа: 23503 в PostgreSQL, ORA-02292 в Oracle.
  • Метод MET, параметр вызова метода MEC и отчёт REP больше не отказывают в переносе других изменений, например подписи метода, если в базе поле пустое (null), а в файле — пустая строка. Раньше перенос падал с сообщением вида «Package не меняется после создания: было=”, стало=”». Настоящая смена такого поля по-прежнему отклоняется.
  • Проверка аргументов отчёта учитывает процедуру PostgreSQL JPP, которая меняется в том же плане. Раньше план показывал ложное предупреждение по старому каталогу приёмника.
  • Oracle: если пакет JPG переносится без тела, а тело приёмника после новой спецификации перестаёт компилироваться, команда пакета завершается ошибкой. Раньше она считалась успешной.

Публичные синонимы Oracle. Публичный синоним JSY (схема PUBLIC) на объект приложения виден в каталоге, учитывается в зависимостях и переносится командой CREATE OR REPLACE PUBLIC SYNONYM. Раньше такой синоним в каталоге не показывался, а из файла создавался неверно и падал с ORA-01031. Публичные синонимы на системные объекты по-прежнему скрыты.

Известные ограничения.

  • SQL-файл, в котором есть и функция PostgreSQL, и таблица с триггером на этой функции, пока пишет таблицу раньше функции. Выполнение такого файла через psql останавливается на «function … does not exist». Перенесите функцию в приёмник до выполнения файла таблицы.
  • PostgreSQL: явное правило сортировки (COLLATE) у колонок таблиц TBP пока не переносится. У полей составных типов оно уже переносится.

Сообщить о проблеме или предложить улучшение в АВИЗО.

Перед отправкой проверьте текст и вложения: удалите пароли, токены, строки подключения и конфиденциальные данные из баз.

Образ Docker: belousov2501/holkas:0.1.35

Страница релиза v0.1.35 на GitHub