PostgreSQL 14 остался без поддержки: план перехода на новую версию

Выпуск 14.25 от 12 ноября стал для ветки последним. Что сделать сегодня, какую версию выбрать, какие изменения 15–18 ломают приложения и как пройти pg_upgrade с возможностью отката.

12 ноября проект PostgreSQL выпустил обновления для всех поддерживаемых веток: 18.7, 17.12, 16.16, 15.20 и 14.25. Они закрывают 52 уязвимости и более 140 ошибок. Для ветки 14 это последний выпуск: в анонсе сказано, что исправления безопасности и ошибок для неё больше не выйдут.

Если ваша база работает на PostgreSQL 14, уязвимости и ошибки, найденные после 12 ноября, останутся в ней незакрытыми. Переезд на новую основную версию занимает больше одного вечера, поэтому ниже — план действий: что сделать сегодня, что проверить за неделю и как провести обновление.

Сегодня: поставьте 14.25

Сначала узнайте точную версию:

SHOW server_version;

Если она ниже 14.25, начните с минорного обновления. Оно не требует ни выгрузки данных, ни pg_upgrade: достаточно остановить сервер, обновить пакет и запустить его снова. Так вы закроете уязвимости из ноябрьского выпуска и выиграете время на подготовку переезда.

После обновления загляните в анонс: часть исправлений требует действий. Проект перечисляет их для версии 18 и уточняет, что многие касаются и остальных веток, поэтому сверьтесь с заметками к 14.25. В списке — перестройка индексов GiST с pg_trgm, подозрительных индексов GIN и индексов B-tree по столбцам bpchar без длины. Тем, кто делает инкрементные резервные копии, проект советует снять новую полную копию.

Выберите целевую версию

Ниже — сроки из политики версий проекта. Каждая ветка живёт пять лет:

Ветка Текущий выпуск Последний выпуск ветки
18 18.7 14 ноября 2030 года
17 17.12 8 ноября 2029 года
16 16.16 9 ноября 2028 года
15 15.20 11 ноября 2027 года

Переход на версию 15 даст всего год до следующего переезда. По нашей оценке, разумные цели сейчас — 17 и 18: у них впереди три и четыре года исправлений. PostgreSQL 19 пока в статусе второго релиз-кандидата, общедоступный выпуск намечен на 19 ноября. Брать только что вышедшую основную версию для срочного переезда мы бы не стали, но решение зависит от вашей политики.

Перескакивать через версии можно: pg_upgrade переносит кластер с 14 сразу на 18.

Что между 14 и 18 может сломать приложение

Полные списки есть в разделах «Migration» заметок к каждой версии. Вот изменения, из-за которых стоит проверить код и конфигурацию в первую очередь:

  • 15: функции pg_start_backup() и pg_stop_backup() переименованы в pg_backup_start() и pg_backup_stop(), монопольный режим резервного копирования удалён. Проверьте скрипты бэкапа. Удалены языки plpython2u и plpythonu.
  • 15: в новых базах у роли PUBLIC больше нет права создавать объекты в схеме public. При обновлении кластера старые права сохраняются. Права в базе, созданной после переезда, зависят от шаблона, из которого она копируется, поэтому проверьте их явно.
  • 16: параметр force_parallel_mode переименован в debug_parallel_query.
  • 17: удалены параметр old_snapshot_threshold и расширение adminpack. Операции обслуживания вроде REINDEX и REFRESH MATERIALIZED VIEW выполняются с безопасным search_path: функциям, которые используются в индексах по выражениям и материализованных представлениях, нужно задать путь поиска при создании.
  • 18: initdb по умолчанию включает контрольные суммы данных, а pg_upgrade требует одинаковых настроек в старом и новом кластере. Аутентификация по паролям MD5 объявлена устаревшей, сервер выдаёт предупреждения.

Параметр, которого в новой версии нет, не даст серверу запуститься. Поэтому проверьте postgresql.conf по этому списку до переезда.

Проведите pg_upgrade с проверкой

Ниже — порядок действий из документации pg_upgrade, пути в примерах условные.

Поставьте рядом пакеты новой версии и те же расширения, что работают в старом кластере. Инициализируйте новый кластер. Если в старом контрольные суммы выключены (это показывает SHOW data_checksums;), создайте новый тоже без них:

/opt/pg18/bin/initdb -D /opt/pg18/data --no-data-checksums

Запустите проверку совместимости. Она ничего не меняет и может идти при включённом старом сервере, если указать его порт и другой порт для нового кластера:

/opt/pg18/bin/pg_upgrade -b /opt/pg14/bin -B /opt/pg18/bin \
  -d /opt/pg14/data -D /opt/pg18/data \
  --old-port 5432 --new-port 50432 --check

Проверка покажет несовместимости, которые умеет находить сама. Гарантии она не даёт: совместимость сторонних расширений pg_upgrade не проверяет, и часть ошибок всплывает только при переносе схемы. Поэтому до боевого переезда прогоните обновление целиком на копии кластера.

Когда репетиция прошла, остановите оба сервера и выполните ту же команду без --check. Это и есть окно простоя. Если собираетесь использовать --link или --clone, добавьте этот ключ и в проверку, и в само обновление.

В конце pg_upgrade может создать SQL-скрипты и попросить их выполнить. Сделайте это до того, как пускать приложение: документация предупреждает, что до перестроения затронутые таблицы могут отдавать неверные результаты.

Затем обновите статистику планировщика. Версия 18 переносит большую её часть сама, остальное досчитывают две команды:

vacuumdb --all --analyze-in-stages --missing-stats-only
vacuumdb --all --analyze-only

Заранее решите, как будете откатываться

Возможность отката зависит от режима pg_upgrade:

  • по умолчанию файлы копируются. Старый кластер остаётся нетронутым, и его можно запустить снова. Цена — двойной объём на диске и время на копирование. Учтите, что данные, записанные в новый кластер после переключения, в старый не попадут;
  • с ключом --link обновление идёт быстро и без удвоения места на диске. Но после первого запуска нового сервера старый кластер использовать нельзя, вернуться получится только из резервной копии;
  • ключ --clone даёт скорость режима --link и оставляет старый кластер рабочим, если файловая система умеет клонировать файлы.

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

Когда pg_upgrade не подходит

Если простой на несколько минут недопустим, переезд делают через логическую репликацию: новая версия поднимается рядом, догоняет старую и принимает нагрузку после переключения. Маленькую базу проще перенести через pg_dump и pg_restore. В управляемых базах облачных провайдеров основную версию обычно меняет сам сервис, но несовместимости из списка выше проверять всё равно вам.

Следующей поддержку потеряет ветка 15 — в ноябре 2027 года. Если поставить напоминание сейчас, тот переезд пройдёт спокойнее.

Источники

ЛУЧШИЕ СТАТЬИ ПО ТЕМЕ

natkaida
17 февраля 2025

🐘 20+ нюансов PostgreSQL, о которых должен знать продвинутый бэкендер

Документация PostgreSQL – лучший источник знаний о СУБД. Но она отличается ...
natkaida
07 августа 2024

🐘🧠 Оптимизация использования памяти в PostgreSQL: секреты профессионалов

PostgreSQL, как и большинство других СУБД, использует много оперативной пам...
saiiiok.patov
07 ноября 2024

🚀🐘 Оптимизация хранимых процедур в PostgreSQL: 4 трюка для взрывного ускорения

Кто из нас не сталкивался с медленными хранимыми процедурами в PostgreSQL? ...