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

Что нового

v0.1.34

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

Что сделать после обновления. Если вы переносили такие объекты прежними версиями, постройте план заново из того же источника. Теперь он покажет расхождения, и применение исправит приёмник.

Незаметная порча при переносе.

  • PostgreSQL: точность timestamp(n) и timestamptz(n), в том числе в массивах, переносится у колонок таблиц TBP и элементов составных типов CTP. Раньше колонка создавалась с точностью по умолчанию. Изменение одной только точности выполняется как изменение колонки.
  • PostgreSQL: параметры представления JVP (security_barrier, check_option и другие) переносятся и сохраняются при каждом изменении. Раньше любое изменение представления молча их сбрасывало. Если файл записан прежней версией и параметров не содержит, Holkas сохраняет параметры приёмника и предупреждает об этом в плане. Чтобы перенести параметры, выгрузите представление заново.
  • Oracle: пробелы в конце строк внутри строковых литералов и идентификаторов в кавычках сохраняются в тексте представлений, функций, процедур, пакетов, типов и триггеров таблиц. Раньше 'A ⏎B' превращалось в 'A⏎B'. Различия только в форматировании вне литералов по-прежнему не попадают в план.
  • Oracle: значения по умолчанию и условия CHECK колонок JTB сохраняют текст литералов. Раньше 'A B' превращалось в 'A B', а строчный комментарий -- в условии поглощал его остаток, и создание падало с ORA-00907.
  • Oracle: колонка VARCHAR2(20 BYTE) остаётся байтовой и в приёмнике, где NLS_LENGTH_SEMANTICS=CHAR. Раньше она становилась VARCHAR2(20 CHAR), а каждый новый план повторял одно и то же изменение. Касается и применения в базу, и SQL-файла.
  • PostgreSQL: триггер таблицы TBP сохраняет режим отключён/REPLICA/ALWAYS при создании, при замене определения и в SQL-файле. Раньше он становился обычным включённым.

Порядок команд. Эти переносы раньше падали при применении, теперь проходят за один перенос.

  • PostgreSQL: внешний ключ на уникальный ключ (UNIQUE) другой таблицы ждёт создания этого ключа, а если ключ не создан, сам пропускается. Раньше перенос мог падать с ошибкой 42830.
  • PostgreSQL: функция или процедура ждёт табличные типы, которые упоминаются в любой её перегрузке, а не только в первой. Раньше перенос мог падать с ошибкой 42704. Тело перегрузки на LANGUAGE sql теперь тоже учитывается, даже если она идёт после перегрузки на PL/pgSQL.
  • Связь LNK, у которой сменился класс-источник, удаляет прежние пары атрибутов и создаёт новые в правильном порядке относительно самой связи. Раньше перенос падал с ошибкой Паруса «нет строки» или с отказом в атрибуте.
  • Колонка представления класса VIW, перешедшая на другой атрибут, освобождает прежний атрибут до его удаления. Раньше удаление атрибута падало с нарушением внешнего ключа.
  • Oracle: изменение таблицы JTB меняет только комментарий самой таблицы, а комментарии колонок пишет и снимает команда колонки. Раньше перенос падал с ORA-00904, если комментарий писался в ещё не добавленную колонку. Снятый в источнике комментарий колонки теперь снимается и в приёмнике.

SQL команд таблицы в плане. У команд таблицы и её колонок, ограничений, индексов и триггеров (TBP и JTB) план показывает SQL. Это ровно тот текст, который Holkas выполнит.

Регистрация объектов после переноса в PostgreSQL. После применения Holkas регистрирует в Парусе только объекты, по которым действительно выполнились команды. Раньше пропущенное или упавшее создание оставляло пустую запись таблицы, представления или последовательности. Неизменённые объекты при этом зря теряли зависимости и права, вычисленные Парусом.

Пустой текст инициализации связей и ограничений. Если в пакете, S3 или git текст инициализации связи LNK или ограничения CNS не указан или равен null, он считается пустым, как в базе. Раньше очистка текста связи не выполнялась, и каждый новый план повторял её. У ограничений повторялось ложное изменение.

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

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

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

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

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