Облачная платформаAdvanced

Обновление основной версии DB Instance в Console

Эта статья полезна?
Язык статьи: Русский
Показать оригинал
Страница переведена автоматически и может содержать неточности. Рекомендуем сверяться с английской версией.

Сценарии

Вы можете обновить основную версию вашего RDS for PostgreSQL instance, чтобы открыть более широкий набор функций.

Методы обновления

RDS for PostgreSQL позволяет обновить основную версию вашего DB instance, используя один из следующих методов:

  • Upgrade without cutover: Это не влияет на рабочие нагрузки. Во время обновления создаётся новый instance с использованием snapshot, и на оригинальном instance не выполняются операции. Основная версия нового instance обновляется. После завершения обновления вы можете подключиться к новому instance для тестирования совместимости рабочей нагрузки. Обновление основной версии может вызвать проблемы совместимости, поэтому настоятельно рекомендуется проводить тестирование совместимости. После успешного прохождения теста выполните обновление с cutover.
  • Upgrade with cutover: В ходе этого процесса создаётся новый instance с использованием snapshot, оригинальный instance переводится в режим только для чтения, и рабочие нагрузки прерываются на несколько минут. После обновления основной версии нового instance виртуальный IP-адрес (VIP) оригинального instance автоматически переключается на новый instance, и ваше приложение автоматически подключается к новому instance. Обновление завершено. После обновления оригинальный instance остаётся только для чтения и не выйдет из этого состояния автоматически.

Поддерживаемые версии

Обновления основной версии поддерживаются для следующих исходных instance:

  • RDS for PostgreSQL 9.5: 9.5.25 или новее
  • RDS for PostgreSQL 9.6: 9.6.24 или новее
  • RDS for PostgreSQL 10: 10.21 или новее
  • RDS for PostgreSQL 12: 12.7 или новее
  • RDS for PostgreSQL 13: 13.3 или новее
  • RDS for PostgreSQL 14: 14.4 или новее
  • RDS for PostgreSQL 15: 15.4 или более поздней
  • RDS for PostgreSQL 16 и RDS for PostgreSQL 17 без ограничений на минорные версии

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

Table 1 Предосторожности при обновлении

Этап

Предосторожности

Ограничения

Перед обновлением

  • Из‑за ограничений ОС некоторые DB instances не поддерживают обновление до мажорной версии. Чтобы проверить, может ли ваш instance быть обновлён, перейдите на страницу Major Version Upgrade в консоли. Некоторые DB instances версии 12 и более поздних поддерживают обновление до мажорной версии между ОС. Однако после обновления резервные копии instance нельзя восстановить в существующий instance.
  • Перед обновлением до мажорной версии выполните проверку обновления. Если в течение периода действия нет успешной проверки обновления, обновление до мажорной версии не допускается.
  • Проверки обновления до мажорной версии потребляют определённые ресурсы. Выполняйте проверку в часы низкой нагрузки.

    Для instances, содержащих большое количество объектов уровня таблиц (например, более 100 000 таблиц, представлений и функций), использование системных ресурсов (особенно CPU и I/O) будет испытывать значительные периодические всплески. Это потребление ресурсов в основном происходит в фазе предварительной проверки, когда на основном узле вызывается инструмент pg_upgrade для сравнения метаданных до и после обновления.

  • При выполнении обновления до мажорной версии на instance некоторые установленные расширения приведут к сбою обновления. Удалите эти расширения перед обновлением. Подробности см. в Extensions Unsupported for Major Version Upgrades.

Во время обновления

  • Если проверка обновления до мажорной версии не удалась и отчёт проверки пуст, обратитесь в службу поддержки.
  • Если вы обновляете ваш instance с переключением нагрузки, instance будет установлен в режим read-only. Instance не будет автоматически разблокирован из состояния read-only даже после обновления. Обновление прервет работу ваших workloads на несколько минут. Выполните обновление в часы низкой нагрузки. Если вы выбираете обновление вашего instance без переключения нагрузки, влияние на ваши workloads отсутствует.

    Параметр default_transaction_read_only управляет настройками read-only. Перед обновлением проверьте, были ли внесены изменения в этот параметр. Если да, данные, вставленные в instance во время переключения нагрузки, будут потеряны после обновления.

  • Обратите внимание, что расширение postgis не поддерживает обновления до мажорной версии.
  • Read replicas не поддерживают обновления до мажорной версии. Если ваш instance имеет read replicas, read replicas не будут обновлены вместе с вашим instance. Вам потребуется воссоздать их после обновления до мажорной версии. Для деталей см. Creating a Read Replica.

После обновления

  • После завершения обновления до мажорной версии создаётся новый DB instance, однако оригинальный DB instance сохраняется и продолжает оплачиваться. Вы можете освободить оригинальный, как только убедитесь, что workloads работают стабильно на новом instance.
  • После завершения обновления до мажорной версии параметры новой версии имеют следующие изменения:
    • Новые параметры в шаблоне параметров новой версии используют значения, определённые в выбранном шаблоне.
    • Существующие параметры в новой версии сохраняют значения из оригинальной версии. Если эти значения выходят за пределы допустимых диапазонов новой версии, вместо них используются значения, указанные в выбранном шаблоне.
    • Параметры из оригинальной версии, не поддерживаемые в новой версии, автоматически удаляются.
    • Специальные параметры: wal_keep_segments (для версий ранее RDS for PostgreSQL 13) и wal_keep_size (для RDS for PostgreSQL 13 и более новых) являются параметрами удержания WAL‑логов. После того как instance обновлён с версии ранее 13 до версии 13 или более новой, wal_keep_size заменяет wal_keep_segments, и его значение автоматически конвертируется.
  • Если обновление до мажорной версии с переключением нагрузки завершено, но нагрузка несовместима с новой версией, необходимо откатить обновление. Обратитесь в службу поддержки, чтобы разблокировать оригинальный instance из состояния read-only. Затем вы сможете продолжить использовать оригинальный instance.
  • Данные, добавленные после завершения обновления с переключением нагрузки, не будут автоматически синхронизированы с оригинальным instance.
  • После обновления до мажорной версии audit logs, error logs и slow query logs оригинального instance по‑прежнему хранятся в оригинальном instance. На новом instance вы можете просматривать только логи, сгенерированные после обновления.
  • Если у текущего instance есть DR instance, обновление до мажорной версии не обновит автоматически DR instance. В результате связь DR будет разорвана, и её необходимо восстановить, используя instance той же версии.
  • Обновление основной версии не обновит версии расширений (см. Supported Extensions). Если новая версия инстанса поддерживает какое‑либо расширение более новой версии, вы можете выполнить ALTER EXTENSION extension_name UPDATE TO 'new_version'; для обновления расширения или удалить и переустановить расширение последней версии.

Extensions Unsupported for Major Version Upgrades

После того как major version upgrade pre-check пройден, если в пути обновления обнаружено какое‑либо расширение, перечисленное в Table 2, удалите расширение до выполнения обновления и переустановите его после завершения обновления. Если выполнить обновление без удаления этого расширения, обновление завершится ошибкой, либо расширение не будет доступно после обновления инстанса.

Table 2 Расширения, не поддерживаемые при обновлении основной версии

Source Version

Target Version

Extension That Needs to Be Uninstalled Before an Upgrade to Prevent Upgrade Failures

Extension That Cannot Be Used After an Instance Upgrade

12

13

orafce, postgis_sfcgal

address_standardizer_data_us, pgaudit

14

orafce, postgis_sfcgal

anon, pgaudit

15

orafce, postgis_sfcgal

anon, pgaudit

16

orafce, postgis_sfcgal, pgl_ddl_deploy

anon, pgaudit

17

orafce, pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal

anon, pgaudit

18

orafce, pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings

anon, pgaudit

13

14

-

anon, pgaudit, pg_stat_kcache

15

-

anon, pgaudit, pg_stat_kcache

16

pgl_ddl_deploy

anon, pgaudit, pg_stat_kcache

17

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal

anon, pgaudit, pg_stat_kcache, powa

18

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings

anon, pgaudit, pg_stat_kcache, powa

14

15

-

pgaudit, pg_stat_kcache

16

pgl_ddl_deploy

pgaudit, pg_stat_kcache

17

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal

pgaudit, pg_stat_kcache, powa

18

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings

pgaudit, pg_stat_kcache, powa

15

16

pgl_ddl_deploy

pgaudit

17

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal

pgaudit, pg_stat_kcache, powa

18

pgl_ddl_deploy, postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings

pgaudit, pg_stat_kcache, powa

16

17

postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal

pgaudit, pg_stat_kcache, powa

18

postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings, pg_tde

pgaudit, pg_stat_kcache, powa

17

18

postgis, postgis_raster, postgis_topology, postgis_tiger_geocoder, postgis_sfcgal, pg_track_settings, pg_tde

pgaudit, pg_stat_kcache, powa

Обновление без переключения

  1. Войдите в консоль управления.
  2. Нажмите в левом верхнем углу страницы и выберите Database > Relational Database Service.
  3. На странице Instances нажмите имя instance name.
  4. В панели навигации выберите Major Version Upgrade.
  5. На отображаемой странице нажмите Upgrade Major Version. В отображаемом диалоговом окне выберите целевую версию и нажмите Next.
  6. На странице предварительной проверки нажмите Check Now. Проверка займет несколько минут.

    Note
    • Если после успешной проверки обновления вы добавите расширения, они могут вызвать проблемы совместимости и привести к сбою обновления. В этом случае выполните проверку повторно. Подробности см. в Extensions Unsupported for Major Version Upgrades.
    • Если проверка обновления завершилась неудачей, вы можете view the check report, нажав View Report на вкладке Upgrade Checks и исправьте несовместимость на основе отчёта.

  7. После успешного прохождения проверки нажмите Next.
  8. На странице выберите шаблон параметров, выберите No для Cutover, нажмите Autofill, чтобы ввести UPGRADE, и нажмите Upgrade Now.
  9. Подтвердите информацию об обновлении и нажмите Submit.
  10. После завершения обновления проверьте наличие нового instance целевой версии. Вы можете подключиться к новому instance, чтобы проверить совместимость нагрузки.

Обновление с Cutover

  1. Войдите в консоль управления.
  2. Нажмите в левом верхнем углу страницы и выберите Database > Relational Database Service.
  3. На странице Instances нажмите имя инстанса.
  4. В панели навигации выберите Major Version Upgrade.
  5. На отображаемой странице нажмите Upgrade Major Version. В отображаемом диалоговом окне выберите целевую версию и нажмите Next.
  6. На странице предварительной проверки нажмите Check Now. Проверка занимает несколько минут.

    Note
    • Если после успешной проверки обновления вы добавляете расширения, они могут вызвать проблемы совместимости и привести к сбою обновления. В этом случае выполните проверку повторно. Подробности см. Extensions Unsupported for Major Version Upgrades.
    • If the upgrade check fails, you can view the check report by clicking View Report on the Upgrade Checks tab page and rectify the incompatibility based on the report.

  7. After the check is passed, click Next.
  8. On the page, choose a parameter template, select Yes for Cutover, specify Collect Statistics, click Autofill to enter UPGRADE, and click Upgrade Now.

    Во время обновления до основной версии статистика оптимизатора не синхронизируется автоматически. Статистику необходимо собрать после завершения обновления.

    • Before cutover: Workload stability is ensured. If your instance has too much data, the upgrade may take a longer time.
    • After cutover: Faster upgrade is ensured. After the upgrade, accessing tables for which no statistics have been generated may cause inaccurate execution plans and even cause the DB instance to be unavailable during peak hours.

  9. Confirm the upgrade information and click Submit.
  10. После завершения обновления проверьте наличие нового instance целевой версии. Ваша рабочая нагрузка автоматически переключается на новый instance.

Отчёты проверки обновления и отчёты обновления

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

  1. Просмотрите файл pg_upgrade_internal.log.

    Файл pg_upgrade_internal.log является основным журналом отчёта проверки обновления или отчёта обновления. Если обновление завершается неудачей, проверьте наличие ошибок в этом файле. Распространённые ошибки перечислены ниже:

    • Список проблемных библиотек находится в файле: loadable_libraries.txt.

      Это означает, что существуют расширения, несовместимые с целевой версией. Они перечислены в loadable_libraries.txt.

    • Список таблиц с проблемой находится в файле: tables_with_oids.txt.

      Это означает, что существуют таблицы, созданные с клаузулой WITH OIDS, и такие таблицы записаны в tables_with_oids.txt. Клауза WITH OIDS не поддерживается в RDS for PostgreSQL 12 и более новых версиях.

    • Обратитесь к последним строкам файла "pg_upgrade_server.log" для определения вероятной причины сбоя.

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

    • Обратитесь к последним строкам файла "pg_upgrade_dump_xxxx.log" для определения вероятной причины сбоя.

      Это означает, что pg_dump не удалось выполнить резервное копирование данных во время обновления, и вы можете проверить pg_upgrade_dump_xxxx.log для выяснения причин.

    • Исходный cluster содержит роли, начинающиеся с "pg_".

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

    • Список проблемных объектов находится в файле: incompatible_polymorphics.txt

      Ваша база данных содержит тип параметра функции anyarray или anyelement, который несовместим с целевой версией. Удалите определения функций до обновления. После завершения обновления восстановите функции и измените тип параметра (с anyarray на anycompatiblearray или с anyelement на anycompatible). Объекты функций записаны в файл incompatible_polymorphics.txt.

  2. Проанализируйте причины на основе элементов отчёта.
    • loadable_libraries.txt

      Этот элемент отображает несовместимые библиотеки, которые обычно соответствуют несовместимым расширениям. Проверьте расширения, перечисленные в loadable_libraries.txt, и определите, следует ли их удалить. Удалите их до обновления, если уверены, что удаление не повлияет на рабочие нагрузки.

    • tables_with_oids.txt

      Этот элемент отображает таблицы, созданные с клаузулой WITH OIDS. Проверьте таблицы, перечисленные в tables_with_oids.txt, и оцените, зависит ли код рабочей нагрузки от OID‑ов. Если удаление OID‑ов из таблиц не влияет на рабочие нагрузки, выполните следующее SQL‑оператор:

      ALTER TABLE {table_name} SET WITHOUT OIDS;
    • pg_upgrade_server.log

      Проверьте последние несколько строк файла pg_upgrade_server.log. Если появляется ошибка, похожая на приведённую ниже, расширение, указанное в этой ошибке, отсутствует в целевой версии. Удалите его из shared_preload_libraries при необходимости и затем выполните обновление.

      FATAL: could not access file "xxx": No such file or directory.

      Пример:

      FATAL: could not access file "pg_pathman": No such file or directory.
    • pg_upgrade_dump_xxxx.log
      • Check the last several lines of pg_upgrade_dump_xxxx.log. If an error similar to the following is displayed, there are too many tables in the current instance. In this case, increase the value of max_locks_per_transaction and perform the upgrade again.
        pg_dump: error: query failed: ERROR: out of shared memory
        HINT: You might need to increase max_locks_per_transaction.
        pg_dump:error: query was: LOCK TABLE "xxx"."xxx" IN ACCESSSHARE MODE
      • Проверьте последние несколько строк pg_upgrade_dump_xxxx.log. Если отображается ошибка, похожая на приведённую ниже, расширение pgl_ddl_deploy присутствует в текущем инстансе. Это расширение несовместимо с целевой версией, поэтому обновление завершилось с ошибкой. Проверьте, есть ли другие несовместимые сторонние расширения в инстансе, основываясь на Extensions Unsupported for Major Version Upgrades (некоторые несовместимые сторонние расширения нельзя определить с помощью проверки обновления). Удалите их при необходимости и затем выполните обновление.
        pg_restore: error: could not execute query: ERROR: could not find function "xxx" in file xxx
        Command was: CREATE FUNCTION "pgl_ddl_deploy"."xxx"
  3. Устраните неисправность, если после неудачной проверки обновления отображается следующее сообщение об ошибке.

    Error message

    Relation names for OID 16479 in database postgres do not match toast: relname recyclebin_tb_1;Relation names for OID 16472 in database postgres do not match toast: relname tb_toast;

    Метод обработки (Следующие операции включают изменения объектов таблиц. Чтобы предотвратить несоответствие данных, остановите все операции записи в целевую таблицу.)

    1. Создайте резервную копию аномальной таблицы. Таблица public.tb_toast используется в качестве примера.
      CREATE TABLE public.tb_toast_bak AS SELECT * FROM public.tb_toast;
    2. Uninstall the recyclebin extension. После её удаления объекты (например recyclebin_tb_1) в корзине будут автоматически удалены.
    3. Удалите аномальную таблицу.
      DROP TABLE public.tb_toast;
    4. Восстановите оригинальное имя таблицы.
      ALTER TABLE public.tb_toast_bak RENAME TO tb_toast;
    5. Снова выполните проверку обновления и убедитесь, что сообщение об ошибке "do not match toast" больше не появляется.