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

Задача / по шагам

Изменить PostgreSQL view и сохранить зависимые объекты

Почему CREATE OR REPLACE не принимает новый тип колонки и как Holkas пересоздаёт представление вместе с зависимостями приёмника.

На этой странице
  1. 01
    Новый запрос

    Изменился тип колонки

  2. 02
    План

    Причина и зависимые объекты

  3. 03
    Пересоздание

    Одна транзакция команды

Проверено на учебных PostgreSQL: название договора расширено с varchar(40) до varchar(120). Местный реестр приёмника сохранил свой запрос, владельца, права и комментарии. Повторный план пустой.

Учебный пример

Разработчик расширил название договора. В новом запросе оно имеет тип varchar(120), а в установленном представлении — varchar(40). Простой CREATE OR REPLACE VIEW такое изменение не принимает. Если удалить представление, этому помешает местный реестр, построенный поверх него.

PostgreSQL разрешает замену view, когда прежние выходные колонки сохраняют имена, порядок и типы; новые колонки можно добавлять в конец. Это ограничение самой команды CREATE VIEW. Holkas сначала использует замену на месте, а несовместимое изменение обрабатывает пересозданием с сохранением поддерживаемых зависимых объектов.

Одинаковое представление не считается изменённым только из-за того, что минорные версии PostgreSQL по-разному оформляют SQL. Если тексты разошлись, Holkas просит приёмник напечатать исходный запрос своей версией СУБД и сравнивает результат. Если черновик создать нельзя, остаётся обычное текстовое сравнение.

JVP

Представление доработки

parus.hksite_v23_contracts — выбираем для переноса из разработки.

VIEW

Местный реестр

parus.hksite_v23_register — есть только в приёмнике и читает представление договоров.

40 → 120

Название договора

Меняется тип выходной колонки представления. Таблицу под ним в этом примере не меняем.

Перед началом

  • 01

    Проверьте характер изменения

    Если меняется только запрос или колонки добавлены в конец, обычно достаточно замены на месте. Пересоздание нужно при несовместимом изменении прежних колонок.

  • 02

    Учтите местные объекты

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

  • 03

    Выберите время применения

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

Выберите изменённое представление

В «Перенести» задайте источник и приёмник PostgreSQL, на шаге «Объекты» добавьте JVP parus.hksite_v23_contracts. Местный реестр из приёмника не нужно разыскивать в источнике. Перейдите к параметрам и запустите план.

В нашем наборе один объект. Изменение его колонки затрагивает реестр приёмника, поэтому внутри одной команды будет больше одного SQL-действия.

Прочитайте причину пересоздания

Откройте строку Update. Holkas объясняет, какая колонка изменилась и почему замена на месте невозможна. В заметке перечислены зависимые объекты, которые будут пересозданы вместе с представлением.

План изменения представления с причиной пересоздания и зависимым реестром
Один выбранный JVP и одна команда Update. План учитывает также местное представление приёмника.

Совместимое изменение

CREATE OR REPLACE сохраняет существующее представление и зависимые объекты.

Несовместимые колонки

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

Прежний текст зависимых

Holkas возвращает местные определения приёмника. Он не переписывает запрос отчёта под новую структуру.

Если вместо готового решения написано, что способ выяснится при применении, черновик нового запроса не удалось проверить. Это не подтверждение безопасной замены на месте.

Посмотрите весь порядок SQL

В карточке команды откройте SQL. Зависимые снимаются от дальних к ближним, затем пересоздаётся выбранное представление; восстановление идёт в обратном порядке. В превью видны DROP и CREATE для затронутых объектов.

Карточка изменения PostgreSQL view с объяснением пересоздания и SQL
Пересоздание отражено в деталях команды до применения. Holkas не добавляет DROP CASCADE.

Для зависимых сохраняются определения, владельцы, права — включая права на колонки и передачу прав — и комментарии. Снимок снимается непосредственно при применении. Если восстановление не удастся, транзакция этой команды откатится.

Проверьте реестр и повторите сравнение

Примените разобранный план. Затем выполните запрос к зависимому реестру и повторите перенос с тем же набором. В нашем примере реестр вернул учебный договор, его колонка стала varchar(120), а новое сравнение не нашло изменений.

Повторный план PostgreSQL view без изменений
Отдельно сверены запрос, владелец, права объекта и колонки, security_barrier и комментарии местного реестра — они сохранились.

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

Представление обновлено

Новый тип колонки подтверждён в приёмнике.

Местный реестр работает

Запрос выполняется; свойства и права сверены.

Повторный план пуст

Перенос выбранного представления сошёлся.

Дальше с этой доработкой

Когда Holkas откажется пересоздавать зависимые

Если поверх реестра создать материализованное представление, план заранее назовёт его и предупредит об отказе команды. В этом примере такой план только построен — применение не запускалось.

Предупреждение плана о материализованном представлении, мешающем пересозданию
Материализованное представление нельзя восстановить тем же способом, что обычный view. Причина видна до применения.
Полные правила представления →

Если что-то пошло не так

Не всякая зависимость поддерживается

Автоматически пересоздаются обычные представления, функции и процедуры, известные каталогу зависимостей. Материализованное представление, таблица с колонкой строчного типа view, неподдерживаемый объект или более двадцати зависимых — причина отказа.

Зависимый тоже меняется в этом плане

План предупредит о конфликте. Разделите переносы и проверьте промежуточное состояние; иногда сначала нужно подготовить совместимое определение зависимого объекта.

Новый запрос не подходит местному отчёту

Прежнее определение зависимого может больше не компилироваться. Тогда команда откатится. Исправление запросов отчётов остаётся отдельной задачей автора доработки.

Ссылки спрятаны внутри программного кода

Каталог не видит обращения из тел PL/pgSQL и динамического SQL. Проверьте вызывающий код отдельно — сам факт успешного пересоздания не доказывает его совместимость.

База занята

Ожидание блокировки при пересоздании ограничено 30 секундами. После отказа разберите активные сеансы и повторите перенос в подходящее время.

Одновременно меняется таблица под представлением

Проверка плана строит черновик по текущему состоянию приёмника. Это не обещание автоматически изменить тип колонки таблицы под цепочкой view. Такой перенос требует отдельного разбора порядка и зависимостей.