Actualización a una nueva versión principal

Elige una ruta de actualización:

En las dos últimas rutas, la nueva implementación no recibe los cambios que llegan a la fuente tras la promoción o tras la copia de seguridad. Prueba y comprueba primero la nueva versión. Antes de la migración definitiva, detén las operaciones de escritura en la fuente. A continuación, active la réplica o realice la copia de seguridad, y cambie los datos de conexión de su aplicación a la nueva implementación.

Busca las versiones disponibles para nuevas implementaciones en el catálogo, con ibmcloud cdb deployables-show, o a través de la API /deployables.

En los ejemplos de API, sustituya {region} por la región de la implementación, {id} por el nombre de recurso en la nube (CRN) codificado en URL de la implementación y <IAM_TOKEN> por su token de acceso de Identity and Access Management (IAM).

Requisitos para la actualización

Compatibilidad de aplicaciones

Prueba la ruta de actualización elegida en un entorno de pruebas representativo antes de pasar a producción. Para realizar una prueba de IPMVU, restaura una copia de seguridad reciente a la versión de PostgreSQL de origen. Una implementación cuenta con dos o tres miembros de datos: el principal y uno o dos miembros de alta disponibilidad (HA). Adapta la implementación restaurada al mismo número de miembros que la de producción, ya que la fase de conversión tarda más cuanto mayor es el número de miembros de alta disponibilidad. Asegúrese de que la implementación restaurada cuente con una copia de seguridad completa y, a continuación, actualícela a la versión deseada. Comprueba las consultas de las aplicaciones, los trabajos en segundo plano, los controladores, las extensiones y los grupos de conexiones. Registra el rendimiento y el tiempo que tus aplicaciones permanecen con errores de solo lectura y fallos de conexión, para poder compararlos posteriormente.

Revisa las notas de la versión de cada versión principal posterior a tu versión de origen, hasta tu versión de destino, incluida esta. Revisa también los cambios en los privilegios de los roles.

La actualización no conserva las marcas de tiempo de las confirmaciones. Tras la actualización, se pg_xact_commit_timestamp() devuelven los resultados de NULL todas las transacciones que se hayan confirmado antes de la actualización. Si tus aplicaciones leen marcas de tiempo de confirmación, copia los valores que necesites en una columna de la tabla antes de realizar la actualización.

Extensiones y otros objetos

Realice los preparativos pertinentes que se indican en las siguientes secciones antes de actualizar. En el caso de un IPMVU, prepara la implementación que vas a actualizar. En el caso de las réplicas de solo lectura y las rutas de restauración, prepara la implementación de origen antes de crear la réplica o realizar la copia de seguridad. No se puede modificar una réplica de solo lectura, y una restauración actualiza los datos en la misma operación. Prevé cualquier dependencia de las aplicaciones respecto a los objetos que elimines.

Extensiones

pg_repack

pg_repack no impide la actualización. No es necesario eliminarlo ni volver a crearlo antes ni después de la actualización.

old_snapshot

El módulo old_snapshot no está disponible en PostgreSQL, versión 17 y posteriores. Al actualizar de PostgreSQL 16 o una versión anterior a PostgreSQL 17 o una versión posterior, IPMVU elimina old_snapshot de cada base de datos antes de que comience el modo de solo lectura. Si algún objeto depende de old_snapshot, la actualización falla. La eliminación no se revertirá si la actualización falla posteriormente.

Si old_snapshot está instalado en alguna base de datos, ponte en contacto con el servicio de asistencia para identificar los objetos dependientes antes de realizar la actualización. Para las demás vías de actualización, ponte en contacto con el servicio de asistencia para coordinar su eliminación.

anon

Si tiene instalada la versión anon 2, siga estos pasos en cada base de datos en la que esté instalada. Ejecútalos como propietario de las tablas enmascaradas, como por ejemplo admin. En el caso de un IPMVU, la versión anon 2 provoca que la actualización falle durante la fase de conversión, mientras la base de datos no está disponible, y todos los reintentos fallan de la misma manera. La anon versión 3 no requiere estos pasos. La consulta de autocomprobación n.º 10 muestra la versión instalada en extversion.

Antes de eliminar las reglas de enmascaramiento, bloquea el acceso a la base de datos para los roles enmascarados, que solo deben ver datos enmascarados. Mantenga bloqueado su acceso hasta que haya restablecido y verificado las reglas de enmascaramiento y las etiquetas de roles tras la actualización.

  1. Anota las reglas de enmascaramiento y los roles enmascarados para poder restaurarlos tras la actualización.

    SELECT objtype, objname, label
    FROM pg_catalog.pg_seclabels
    WHERE provider = 'anon';
    
  2. Elimina todas las reglas de enmascaramiento.

    SELECT anon.remove_masks_for_all_columns();
    
  3. Elimina la etiqueta enmascarada de cada función que aparece en el paso 1. En PostgreSQL 16 y versiones posteriores, esta acción requiere la opción ADMIN en el rol. Para obtener más información, consulta Problemas con los privilegios de los roles durante las actualizaciones de versión.

    SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
    
  4. Elimine la extensión anon con la opción de cascada. La opción cascada también elimina los objetos que dependen de anon, como las vistas de enmascaramiento y las funciones. Anota sus definiciones para poder reproducirlas tras la actualización.

    DROP EXTENSION anon CASCADE;
    
  5. Tras la actualización, vuelva a habilitar anon, vuelva a aplicar las reglas de enmascaramiento y las etiquetas de rol registradas, y compruebe el enmascaramiento antes de restablecer el acceso a los roles enmascarados.

PostGIS

Si utilizas PostGIS, actualízalo en cada base de datos que lo utilice antes de actualizar PostgreSQL:

SELECT postgis_extensions_upgrade();

Comprueba la versión de la extensión:

SELECT postgis_full_version();
earthdistance

Un IPMVU falla durante la fase de conversión si un índice o una columna generada almacenada utiliza una función de la versión earthdistance 1.1, como ll_to_earth(). Esto también se aplica cuando el objeto lo utiliza a través de tu propia función SQL. PostgreSQL 14 y 15 solo ofrecen la versión 1.1. Comprueba la consulta de autocomprobación 13 en cada base de datos y, a continuación, gestiona cada objeto de la lista:

  • En PostgreSQL 16 o 17, actualiza la extensión antes de realizar la actualización:

    ALTER EXTENSION earthdistance UPDATE;
    
  • En PostgreSQL 14 o 15, si used_function es una de tus propias funciones, añádele un ajuste search_path:

    ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog;
    
  • En PostgreSQL 14 o 15, si used_function es una función earthdistance, elimina el índice indicado antes de actualizar. Para conservar los valores de una columna generada que aparece en la lista, conviértela en una columna normal con ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Tras la actualización, ejecuta y ALTER EXTENSION earthdistance UPDATE;, a continuación, vuelve a crear lo que hayas eliminado. Si tu objetivo es PostgreSQL 15, la actualización no tiene ningún efecto, y los objetos que vuelvas a crear bloquearán tu próxima actualización de la misma manera. Para evitarlo, actualiza a PostgreSQL 16 o una versión posterior.

pgRouting

Si su implementación ejecuta PostgreSQL 16 o 17 y realiza una actualización a PostgreSQL 18, compruebe cada base de datos en la que esté pgRouting instalado. Las implementaciones de PostgreSQL 18 no incluyen la biblioteca pgRouting 3.5. Un IPMVU para PostgreSQL 18 no supera las comprobaciones de compatibilidad, antes de que comience el modo de solo lectura, mientras cualquier función utilice esa biblioteca. No se esperan errores:

SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';

Si la consulta devuelve una fila, actualízala a pgRouting la última versión que ofrezca tu implementación antes de actualizar y, a continuación, vuelve a ejecutar la consulta:

ALTER EXTENSION pgrouting UPDATE;

pgRouting La versión 4.0 elimina varias funciones, como pgr_createTopology, pgr_analyzeGraph, y pgr_nodeNetwork, y modifica otras. Prueba primero tus aplicaciones con la versión 4.0 en pgRouting un entorno de prueba. Si necesitan las funciones eliminadas, pónganse en contacto con el servicio de asistencia antes de actualizar a PostgreSQL 18. A partir de PostgreSQL 16, también puedes actualizar a PostgreSQL 17, que incluye la biblioteca 3.5.

Funciones SQL en índices, claves de partición y columnas generadas

Durante la fase de conversión, un IPMVU vuelve a crear la definición de cada índice, clave de partición y columna generada almacenada con una ruta de búsqueda vacía. Este paso falla si uno de estos objetos utiliza una función LANGUAGE sql cuyo cuerpo es una cadena que nombra un objeto externo sin pg_catalog su esquema, ya sea directamente o a través de una restricción de comprobación de dominio. Las estadísticas ampliadas tienen el mismo efecto en una tabla que tiene una clave externa. En un índice, también falla una llamada que especifica el esquema ibm_extension en el que están instaladas las extensiones. El fallo se produce mientras la base de datos no está disponible, y cada nuevo intento falla de la misma manera.

Ejecuta la consulta de autocomprobación n.º 12 en cada base de datos. Para cada función de la lista, añade una configuración search_path que enumere todos los esquemas que utiliza su cuerpo. Como alternativa, sustituye su cuerpo de cadena por un cuerpo conforme al estándar SQL. Ejecuta estas instrucciones como propietario de la función. Por ejemplo:

ALTER FUNCTION f_unaccent(text) SET search_path = ibm_extension, pg_catalog;
CREATE OR REPLACE FUNCTION f_unaccent(text) RETURNS text
  LANGUAGE sql IMMUTABLE PARALLEL SAFE STRICT
  RETURN ibm_extension.unaccent('ibm_extension.unaccent', $1);

Mantenga sin cambios los resultados y demás atributos de cada función, ya que los índices y las columnas generadas almacenan dichos resultados, y las tablas particionadas dirigen las filas en función de ellos. Con esta configuración search_path, PostgreSQL ya no expande la función en las consultas que la invocan, por lo que dichas consultas pueden ser más lentas. Un cuerpo estándar de SQL no protege las funciones de cuerpo de cadena que invoca, así que corrige también esas funciones. Vuelve a ejecutar la consulta hasta que no devuelva ninguna fila. Si se menciona una función de la que no dispones, ponte en contacto con el servicio de asistencia antes de actualizar.

Si actualizas de PostgreSQL 16 o una versión anterior a PostgreSQL 17 o una versión posterior, ejecuta también la consulta de autocomprobación 17. PostgreSQL 17 y versiones posteriores ejecutan comandos de mantenimiento con una ruta de búsqueda restringida. Una función en cualquier lenguaje que utilice un índice, una vista materializada o estadísticas ampliadas necesita entonces su propia search_path configuración. De lo contrario, tras la actualización, ANALYZE, REINDEX, CLUSTER, VACUUM FULL, y fallarán REFRESH MATERIALIZED VIEW para los objetos afectados. Configure la ruta de búsqueda de cada función de la lista que nombre objetos sin su esquema, tal y como se ha mostrado en el ejemplo anterior. Para obtener más información, consulta las notas de migración a PostgreSQL 17.

Objetos que utilizan nombres de sistema eliminados

Cada versión principal elimina o renombra algunas columnas del catálogo del sistema, funciones y parámetros de configuración. Por ejemplo, en PostgreSQL 17 se eliminaron las columnas de punto de control de pg_stat_bgwriter, y en PostgreSQL 16 se renombró el parámetro force_parallel_mode a debug_parallel_query. Las comprobaciones previas no detectan los objetos que utilizan estos nombres:

  • Si una vista, una vista materializada o un agregado utiliza un nombre eliminado, la IPMVU falla durante la fase de conversión. Una función con un cuerpo conforme al estándar SQL y una función, un rol o una configuración de base de datos de un parámetro eliminado tienen el mismo efecto.
  • Otras funciones y procedimientos, tareas pg_cron y consultas de aplicaciones que utilicen un nombre eliminado fallarán la primera vez que se ejecuten en la nueva versión. Esto puede ocurrir antes de que se reanuden las escrituras.

Ejecute la consulta de autocomprobación 14 en cada base de datos. Modifica o elimina cada uno de los objetos de la lista cuya removed_in versión sea igual o inferior a la versión objetivo. Comprueba la configuración de roles y de la base de datos con la consulta de autocomprobación 7. Prueba tu aplicación y tus consultas de supervisión en una implementación de prueba de la versión de destino.

Espacios de replicación lógica

IPMVU no supera sus comprobaciones previas mientras exista alguna ranura de replicación lógica, incluidas las ranuras inactivas y las que wal2json utiliza. No es posible recuperar una ranura eliminada, y una nueva ranura no incluye los cambios que contenía la anterior. Antes de actualizar:

  1. Anota el nombre de cada ranura, el complemento y la base de datos con la consulta de autocomprobación 2.

  2. Detenga la escritura en la fuente hasta que haya restaurado los consumidores tras la actualización, o hasta que tenga previsto resincronizar los datos posteriores.

  3. Permita que los usuarios procesen los cambios pendientes y, a continuación, deténgalos. Manténlos detenidos, con la reconexión automática desactivada, hasta que la tarea aparezca como Completada.

  4. Elimina cada ranura con el comando ibmcloud cdb postgresql replication-slot-delete o mediante la API Eliminar una ranura de replicación lógica. El usuario admin no puede eliminar ranuras de replicación con SQL.

    ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME>
    
  5. Tras la actualización, vuelve a crear las ranuras tal y como se describe en Configuración wal2json.

wal2json es un complemento de decodificación lógica de salida, no una extensión que se crea con CREATE EXTENSION.

Suscripciones lógicas

Una suscripción lógica recibe las modificaciones de un editor. Su ranura de replicación se encuentra en el editor, por lo que la consulta de ranuras no la muestra.

Si tu implementación ejecuta PostgreSQL 16 o una versión anterior, IPMVU no supera sus comprobaciones previas mientras exista alguna suscripción lógica, incluidas las suscripciones desactivadas. Las actualizaciones desde estas versiones no conservan el estado de sincronización de la suscripción. Antes de actualizar, acuerde con el propietario del editor cómo eliminar y volver a crear cada suscripción, y cómo resincronizar los datos. A continuación, elimina las suscripciones con las funciones de suscripción. La función delete_subscription también elimina la ranura de la suscripción en el editor, y falla si no se puede acceder al editor o si la ranura ya no existe. En ese caso, ejecuta y disable_subscription, a continuación, antes subscription_slot_none de delete_subscription. A continuación, pide al propietario del editor que elimine el slot, ya que sigue conservando registros de transacciones en el editor.

Si su implementación ejecuta PostgreSQL 17 o una versión posterior, las suscripciones pueden mantenerse, pero deben cumplir los requisitos de actualización de la replicación lógica de la versión de destino. La actualización admite un máximo de 10 suscripciones. Si se añade más, no supera las comprobaciones de compatibilidad antes de que comience el modo de solo lectura. Desactiva las suscripciones con antes disable_subscription de actualizar y actívalas con una vez enable_subscription finalizada la actualización.

UNLOGGED tablas y secuencias

PostgreSQL no registra los cambios en las tablas UNLOGGED y secuencias en el registro de transacciones. No los replica a otros miembros y los restablece tras una conmutación por error o una restauración. Ninguna de las rutas de actualización conserva su contenido:

  • Un IPMVU los restablece al reiniciar PostgreSQL con la nueva versión, y de nuevo al cambiar el rol principal en la fase de finalización. Una actualización fallida también puede restablecerlos.
  • Una réplica promocionada de solo lectura y una copia de seguridad restaurada comienzan con tablas UNLOGGED vacías y UNLOGGED secuencias reiniciadas.

Tras la actualización, las tablas UNLOGGED quedan vacías y las secuencias UNLOGGED se reinician. Hasta que la tarea aparezca como Completada, cualquier cambio que realices en estos objetos también podría perderse. Antes de actualizar, utilice la consulta de autocomprobación 11 para identificar estos objetos en cada base de datos y planifique cómo gestionar cada uno de ellos.

  • Para conservar el contenido de una tabla, conviértela con ALTER TABLE <table_name> SET LOGGED;. También SET LOGGED convierte los índices de la tabla y las secuencias que le pertenecen. Convierte una tabla a la que se hace referencia antes de convertir cualquier tabla que haga referencia a ella mediante claves externas. Como alternativa, exporta el contenido y vuelve a cargarlo una vez que la tarea aparezca como Completada.
  • Si una secuencia genera valores para una tabla registrada, conviértela con ALTER SEQUENCE <sequence_name> SET LOGGED;. De lo contrario, detén las aplicaciones que lo utilicen hasta que la tarea aparezca como Completada. A continuación, fíjalo por encima del valor más alto en uso con la función setval.

SET LOGGED Reescribe la tabla y bloquea las lecturas y escrituras hasta que finalice la operación. Además, genera aproximadamente la misma cantidad de datos de registro de transacciones que ocupan la tabla y sus índices. Convierte bien las tablas grandes antes de enviar la actualización y utiliza la consulta de autocomprobación 5 para verificar que se han archivado los registros de transacciones. Tras la actualización, puedes volver a convertir una tabla con ALTER TABLE <table_name> SET UNLOGGED;.

En el caso de un IPMVU, una tabla UNLOGGED, incluso si está vacía, también hace que el servicio vuelva a crear todos los miembros de alta disponibilidad (HA), lo que prolonga el tiempo durante el cual se bloquean las escrituras. Para obtener más información, consulta Disponibilidad durante una actualización. Para evitar esta reconstrucción, convierte todas las tablas UNLOGGED o elimina aquellas que ya no necesites. TRUNCATE Esto no evita la reconstrucción. Las secuencias UNLOGGED no provocan una reconstrucción. En PostgreSQL 16 y 17, SET LOGGED es en sí misma una operación masiva que puede provocar una reconstrucción, así que hay que tenerlo en cuenta.

Actualización in situ a una versión principal

Realice todos los preparativos y, a continuación, utilice la interfaz de usuario, la API, la CLI o el procedimiento de Terraform que se indica a continuación.

En una IPMVU, el servicio actualiza el servidor principal in situ y actualiza cada miembro de alta disponibilidad a partir de sus archivos de datos existentes. Cuando todos los miembros de HA pueden reutilizar sus archivos de datos, las operaciones de escritura solo se bloquean durante un breve periodo de tiempo. La duración depende principalmente del número de objetos de la base de datos y del nivel de actividad de la misma, más que de la cantidad de datos almacenados.

En determinadas condiciones, el servicio copia toda la base de datos a los miembros de alta disponibilidad, lo que mantiene las escrituras bloqueadas durante mucho más tiempo. Otras condiciones provocan que la actualización falle una vez bloqueadas las operaciones de escritura. Las comprobaciones previas no detectan estas condiciones, por lo que debes resolverlas antes de enviar la actualización. Para consultar la lista, véase Condiciones que las comprobaciones previas no detectan.

No se puede cancelar una IPMVU una vez enviada, ni se puede reducir la versión de la implementación ya realizada. El servicio no realiza una copia de seguridad de los datos antes de la actualización, por lo que primero debe crear y verificar una copia de seguridad bajo demanda.

Disponibilidad durante una actualización

Una IPMVU se ejecuta en las siguientes fases. Las operaciones de escritura se detienen cuando comienza la fase de solo lectura y se reanudan cuando el servicio sale del modo de solo lectura. Las lecturas tampoco están disponibles durante la fase de conversión.

Fases y disponibilidad de IPMVU
Fase ¿Qué ocurre? Lecturas Escrituras
Comprobaciones El servicio espera a que finalicen los cambios de implementación pendientes y ejecuta las comprobaciones previas. Comprueba la compatibilidad de la actualización en el miembro principal y en los miembros de alta disponibilidad, y suspende la conmutación automática por error. Disponible Disponible
Sólo lectura El servicio establece las nuevas transacciones como de solo lectura en todas las bases de datos y cierra todas las sesiones de los clientes. A continuación, espera a que los miembros de alta disponibilidad y el archivado del registro de transacciones se pongan al día. Disponible Bloqueado
Conversión El servicio detiene PostgreSQL en todos los miembros y actualiza el principal. Siempre que sea posible, actualiza cada miembro de HA a partir de los archivos de datos existentes de dicho miembro. No disponible No disponible
Reiniciar El servidor principal actualizado se inicia en modo de solo lectura y se inician los miembros de alta disponibilidad. El servicio recrea cualquier miembro que no pueda reutilizar sus archivos de datos del primario actualizado. Disponible Bloqueado
Redacta currículums El servicio desactiva el modo de solo lectura y vuelve a cerrar todas las sesiones de los clientes. Disponible Disponible
Finalización El servicio espera a que todos los miembros de alta disponibilidad se pongan al día. A continuación, el servicio reinicia los componentes uno a uno para completar la migración de la implementación a la nueva versión. Antes de reiniciar el nodo principal, el servicio transfiere la función principal a otro miembro, lo que pone fin a las sesiones de los clientes. A continuación, el servicio elimina los archivos de actualización, pone en cola la copia de seguridad posterior a la actualización y marca las tareas como Completadas. Disponible, excepto durante el cambio de horario Disponible, excepto durante el cambio de horario

Se reescribe el resumen una vez que al menos un miembro del HA se ha puesto al día y todos los demás miembros del HA se han puesto al día o se están reconstruyendo. El servicio reconstruye un miembro de alta disponibilidad (HA) que no puede reutilizar sus archivos de datos copiando en él toda la base de datos. Si es necesario reconstruir todos los miembros de HA, las operaciones de escritura permanecen bloqueadas hasta que finalice la primera reconstrucción. En el caso de una base de datos de gran tamaño, esto puede llevar horas. Una implementación con dos miembros de datos, que es la configuración predeterminada, solo tiene un miembro de alta disponibilidad. Como resultado, cualquier reconstrucción bloquea las escrituras. Los miembros de HA no pueden reutilizar sus archivos de datos en las siguientes situaciones:

  • Cualquier base de datos contiene una tabla UNLOGGED, aunque esté vacía. A continuación, el servicio vuelve a crear todos los miembros de alta disponibilidad. Consulte la consulta de autocomprobación 11 y vea las tablas UNLOGGED y secuencias.
  • La implementación ejecuta PostgreSQL 16 o 17, y las tablas han crecido debido a operaciones masivas o a numerosas inserciones o actualizaciones simultáneas. Las operaciones masivas incluyen comandos ALTER TABLE COPY, pg_restore, CREATE TABLE AS, CREATE MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW, y, que reescriben una tabla, como por ejemplo SET LOGGED. No es posible comprobarlo con antelación, así que planifica una reconstrucción.

El servicio también puede reconstruir miembros de alta disponibilidad (HA) por otros motivos que no se pueden comprobar de antemano. Es posible que una prueba realizada en un entorno de staging que se restaure a partir de una copia de seguridad no muestre dicha reconstrucción.

Un miembro de HA en proceso de reconstrucción conserva sus archivos de datos anteriores hasta que finalice la tarea. Por lo tanto, requiere un espacio libre en disco al menos igual al espacio que ocupan sus datos. Antes de enviar la actualización, asegúrate de que cada miembro de datos utilice bastante menos de la mitad de su espacio en disco disponible. Comprueba este valor utilizando la métrica de espacio en disco utilizado. Aunque la comprobación previa del espacio en disco permite una utilización del disco de hasta el 90 %, la reconstrucción de un miembro de alta disponibilidad (HA) requiere mucho más espacio libre. De lo contrario, la reconstrucción puede quedarse sin espacio en disco y fallar repetidamente. Las operaciones de escritura pueden permanecer bloqueadas durante horas antes de que la tarea falle. El escalado automático y manual del disco espera a que finalice la actualización, por lo que debes escalar el disco antes de iniciar la actualización. Una reconstrucción prolongada también puede provocar que la tarea falle una vez que se reanuden las escrituras. En ambos casos, la implementación ejecuta la versión de destino hasta que el servicio de soporte técnico complete la actualización. Prevea una reconstrucción durante su ventana de mantenimiento.

Redacta el currículum antes de que finalice la tarea. Para comprobar si se han reanudado las escrituras, ejecuta SHOW default_transaction_read_only; en una nueva sesión. Se restablece una off vez que se reanudan las operaciones de escritura. Las sesiones de los clientes finalizan cuando se inicia el modo de solo lectura, cuando PostgreSQL se detiene para la conversión, cuando se reanudan las operaciones de escritura, durante la conmutación en la fase de finalización y cuando el servicio restablece el acceso de escritura tras un fallo.

Hasta que la tarea aparezca como Completada, evita las escrituras masivas prolongadas, como cargas de datos de gran volumen o trabajos por lotes. La fase de finalización espera hasta que todos los miembros de la alta disponibilidad (HA) hayan reproducido todos los cambios. Bajo una carga de escritura intensa y continua, esta espera puede agotarse y, a continuación, la tarea falla tras reanudarse las escrituras. El riesgo es mayor mientras se está reconstruyendo un miembro de HA. A continuación, la implementación ejecuta la versión de destino sin una copia de seguridad posterior a la actualización, y el servicio de asistencia técnica debe completar la actualización.

Para comprobar si tu carga de escritura permite que los miembros de alta disponibilidad se pongan al día, ejecuta la siguiente consulta en el momento previsto para la actualización. Repítelo cada segundo durante unos minutos, por ejemplo, con el comando psql \watch 1. El servicio requiere que todos los miembros de HA se 0 conecten replay_lag_bytes al mismo tiempo. Si esto no ocurre nunca, reduce la carga de escritura antes de enviar la actualización.

SELECT application_name, state,
       pg_catalog.pg_wal_lsn_diff(pg_catalog.pg_current_wal_lsn(), replay_lsn) AS replay_lag_bytes
FROM pg_catalog.pg_stat_replication
ORDER BY application_name;

La actualización no actualiza las estadísticas del optimizador, por lo que las consultas pueden elegir planes lentos hasta que se ejecute ANALYZE. Las actualizaciones a PostgreSQL 15, 16 o 17 no transfieren las estadísticas. Las actualizaciones a PostgreSQL 18 transfieren la mayoría de las estadísticas, pero no las estadísticas ampliadas que hayas creado con CREATE STATISTICS, ni las estadísticas que recopilan extensiones como PostGIS. El proceso autovacuum analiza una tabla solo después de que se hayan realizado suficientes escrituras, y nunca analiza tablas particionadas. No espere a que se complete la tarea. En cuanto SHOW default_transaction_read_only; vuelva off, actualice las estadísticas tal y como se describe en Después de la actualización.

El modo de solo lectura establece un valor predeterminado para las nuevas transacciones. No bloquea la base de datos. Una sesión que establezca default_transaction_read_only en off, o que inicie explícitamente una transacción de lectura-escritura, aún puede escribir. Lo mismo ocurre con un rol cuyo propio default_transaction_read_only entorno es off. Comandos de mantenimiento como VACUUM, ANALYZE, REINDEX, y también CLUSTER siguen funcionando. El modo de solo lectura no detiene un trabajo pg_cron que ya se esté ejecutando ni una suscripción activada en PostgreSQL 17. Este tipo de operaciones de escritura pueden provocar que la actualización falle. Antes de enviar la actualización, detén los procesos que anulan el modo de solo lectura. Detén las tareas programadas que escriben o ejecutan comandos de mantenimiento, como las tareas pg_cron de, y espera a que finalicen las tareas en ejecución. Reúnelos tal y como se describe en Después de la actualización.

Las lecturas también pueden escribir registros de transacciones durante el modo de solo lectura, por ejemplo, la primera vez que las consultas leen filas tras una carga masiva o una actualización de gran volumen. Esta actividad retrasa la puesta al día que esperan las fases de solo lectura y de reinicio, por lo que las operaciones de escritura permanecen bloqueadas durante más tiempo y la actualización puede fallar. Antes de enviar la actualización, ejecuta en VACUUM las tablas que hayas cargado recientemente o modificado de forma significativa.

Cuando el servicio finaliza una sesión, un cliente que se conecta directamente a la implementación recibe el código SQLSTATE ( 57P01``admin_shutdown ). Una operación de escritura en una transacción de solo lectura falla con el código SQLSTATE 25006 (read_only_sql_transaction). Durante la fase de conversión, una nueva conexión puede fallar con un error de autenticación, como el código SQLSTATE 28P01, aunque tus credenciales no hayan cambiado. Vuelve a intentar la conexión tras la conversión. Si estos errores persisten después de que la tarea aparezca como Fallida, ponte en contacto con el servicio de asistencia. A través de un gestor de conexiones, las aplicaciones pueden detectar otros errores de conexión.

Los clientes que solo admiten sesiones de lectura y escritura no pueden conectarse mientras el modo de solo lectura esté activado, por lo que tampoco podrán realizar lecturas hasta que se reanuden las operaciones de escritura. Esto se aplica a los clientes libpq que establecen target_session_attrs=read-write, y a los clientes JDBC que establecen targetServerType=primary o master. Para mantener las lecturas disponibles, utiliza target_session_attrs=any, o primary con la versión 14 libpq o posterior. Para JDBC, utiliza targetServerType=any.

Las aplicaciones deben gestionar los fallos de conexión y los errores de solo lectura, volver a conectarse y reintentar las transacciones interrumpidas únicamente cuando sea seguro hacerlo. El uso de un grupo de conexiones no elimina estos requisitos. El acceso a la aplicación no garantiza que la tarea de actualización se haya completado.

Copias de seguridad y recuperación

El servicio no realiza una copia de seguridad de los datos antes de la actualización. Crea y verifica una copia de seguridad bajo demanda reciente antes de IPMVU. Para volver a la versión original tras una actualización, restaura una copia de seguridad o un punto de recuperación anterior a la actualización en una nueva implementación que ejecute la versión original. Especifica la versión de forma explícita, ya que una restauración a un momento determinado sin especificar una versión crea una implementación que ejecuta la versión actual. Esta opción requiere que la versión original siga estando disponible para nuevas implementaciones. Tenga en cuenta los cambios realizados desde entonces.

Tras una actualización correcta, el servicio pone en cola una copia de seguridad de la implementación actualizada. La copia de seguridad se ejecuta por separado una vez finalizada la tarea de actualización y es posible que no se inicie de inmediato. Esta primera copia de seguridad en la nueva versión copia toda la base de datos, por lo que puede tardar varias horas en el caso de una base de datos grande. Comprueba su estado en Copias de seguridad y restauración. Si falla, realiza una copia de seguridad bajo demanda y ponte en contacto con el servicio de asistencia si los fallos persisten. Un fallo en la copia de seguridad no revierte la actualización.

La recuperación a un momento determinado (PITR) no puede reproducir transacciones que abarcan una actualización de versión principal. Puede restaurar el sistema a un momento anterior al inicio de la tarea de actualización o posterior a la finalización de la primera copia de seguridad de la implementación actualizada. No se admiten las restauraciones a puntos de recuperación situados entre la actualización y la finalización de la copia de seguridad posterior a la actualización. El servicio rechaza algunos de estos puntos de recuperación, mientras que las restauraciones a otros pueden aceptarse, pero fallan durante el proceso de restauración. Este periodo no cubierto incluye el tiempo transcurrido tras la reanudación de las escrituras. Hasta que finalice la copia de seguridad posterior a la actualización, las restauraciones al último punto de recuperación disponible también pueden fallar, incluso si el servicio acepta la solicitud de restauración.

Para mantener la cobertura de PITR en caso de cambios tras la actualización, mantenga en pausa las operaciones de escritura de la aplicación hasta que finalice la copia de seguridad posterior a la actualización. Incorpóralos a tus aplicaciones. Cuando se reanudan las operaciones de escritura, la actualización se reinicia en default_transaction_read_only cada base de datos, por lo que una configuración de solo lectura a nivel de base de datos no mantiene las operaciones de escritura en pausa.

Una actualización fallida no pone en cola una copia de seguridad. Es posible que PITR no esté disponible en determinados momentos entre el inicio del intento y la siguiente copia de seguridad completada. Si, tras una actualización fallida, indica SHOW server_version; la versión de origen y el entorno de implementación admite operaciones de escritura, realiza una copia de seguridad bajo demanda. De lo contrario, ponte en contacto con el servicio de asistencia antes de realizar una copia de seguridad o cualquier otro cambio.

Las copias de seguridad y los puntos de recuperación anteriores a la actualización pertenecen a la versión anterior y siguen estando sujetos a los límites de retención. Para obtener más información, consulta PITR.

Las opciones de omisión de copias de seguridad no son compatibles con PostgreSQL: skip_backup en la API, --skip-backup en la CLI y version_upgrade_skip_backup en Terraform. Las solicitudes que permiten que fallen. La API y la CLI devuelven un error, y los planes de Terraform fallan.

Antes de empezar

Aplica estos requisitos tanto al entorno de pruebas como al de producción:

  • Realice los preparativos para la aplicación, la extensión y la replicación, así como para la copia de seguridad.

  • Solucione los problemas que no detectan las comprobaciones previas y ejecute las consultas de autocomprobación.

  • Asegúrese de que cada miembro de datos utilice bastante menos de la mitad de su espacio en disco disponible, de modo que no se agote el espacio al reconstruir los miembros de alta disponibilidad. Para obtener más información, consulta Disponibilidad durante una actualización.

  • Asegúrese de que la implementación cuente con al menos una copia de seguridad completa. Hasta entonces, la consola desactiva el botón Actualizar versión principal y la API rechaza la solicitud.

  • IPMVU no está disponible en una implementación de réplica de solo lectura. Para actualizar una réplica, promuévela mediante una actualización de versión.

  • Actualice o elimine todas las réplicas de solo lectura de la implementación, incluidas las réplicas de otras regiones, y espere a que finalice cada operación. Una réplica eliminada permanece asociada a la implementación hasta que se elimina de forma permanente. La actualización no supera las comprobaciones previas mientras haya alguna réplica asociada a la implementación. Planifica las aplicaciones que leen desde estas réplicas. Para obtener más información, consulta Réplicas de solo lectura e IPMVU.

  • Realiza una actualización cada vez. El servicio rechaza una nueva solicitud de actualización mientras hay otra tarea de actualización en cola o en ejecución.

  • Si ha establecido la configuración synchronous_commit de la implementación en on, cámbiela a antes local de enviar la actualización. Vuelve a cambiarlo una vez que la tarea aparezca como Completada. Con on, una actualización fallida puede dejar todas las bases de datos en modo de solo lectura o provocar que las confirmaciones queden en espera hasta que el servicio de asistencia técnica restablezca la implementación. La configuración de la implementación es on si la siguiente consulta devuelve on con la fuente configuration file:

    SELECT setting, source
    FROM pg_catalog.pg_settings
    WHERE name = 'synchronous_commit';
    
  • Elige un objetivo de entre las capacidades de tu implementación. Puede actualizar directamente a cualquier versión posterior que aparezca como transición de actualización, sin pasar por versiones intermedias. Una versión que se pueda aprovisionar no tiene por qué ser necesariamente un destino de actualización in situ:

    ibmcloud cdb deployment-capability-show <NAME|CRN> versions
    

    En el resultado, utiliza el valor to_version de una entrada de Transición de actualización.

Comprobaciones previas y preparación

El servicio realiza las siguientes comprobaciones antes de que comience el modo de solo lectura. Si una comprobación falla, la tarea muestra el estado Fallida y la implementación se mantiene en su versión actual sin bloquear las operaciones de escritura. Si alguna base de datos tiene configurado default_transaction_read_only en on, una comprobación fallida también restablece esta configuración en todas las bases de datos y cierra todas las sesiones de los clientes. La tarea no indica qué comprobación ha fallado, así que comprueba cada elemento antes de enviar la actualización.

Comprobaciones previas de IPMVU
Marcado Se considera correcto cuando Su acción
Estado de la implementación Todos los miembros de datos están en funcionamiento, y cada miembro de alta disponibilidad (HA) está recibiendo datos en streaming desde el primario. Deja que finalicen el escalado, el mantenimiento y las reconstrucciones de miembros de alta disponibilidad. Compruébalo con la consulta de autocomprobación 1. Otras tareas no fallan en esta comprobación, pero retrasan el inicio de la actualización. Consulta las tareas recientes o muestra una lista de tareas con ibmcloud cdb deployment-tasks-list. Si esta comprobación sigue fallando, ponte en contacto con el servicio de asistencia.
Espacio de disco Cada miembro de datos utiliza como máximo el 90 % del espacio en disco que se le ha asignado. Amplíe la capacidad del disco o elimine los datos que ya no necesite. Las ranuras de replicación lógica no utilizadas también pueden conservar los registros de transacciones. Esta comprobación permite hasta un 90 %, pero para reconstruir los miembros de alta disponibilidad (HA) es necesario que cada miembro de datos utilice bastante menos de la mitad de su disco. Consulte Disponibilidad durante una actualización.
CPU, memoria y E/S de disco En cada miembro de datos, la media de carga de 1 minuto del host es, como máximo, el 90 % de su número de CPU, y el uso de memoria del host es, como máximo, del 90 %. La utilización de E/S de disco tampoco supera el 90 %. Actualiza durante un momento de poca actividad o vuelve a enviar la actualización más tarde. El servicio mide la carga y la memoria de todo el host, incluidas otras cargas de trabajo que se ejecutan en él, y toma muestras de la E/S del disco durante unos segundos. La media de carga también tiene en cuenta los procesos que esperan a que se realice una operación de E/S de disco. Por lo tanto, sus valores pueden diferir de tus métricas de supervisión, y es posible que ampliar tu implementación no los reduzca. Si esta comprobación sigue fallando, ponte en contacto con el servicio de asistencia.
Archivado del registro de transacciones El archivado no está fallando y no hay más de 4 GB de registros de transacciones pendientes de archivado. Reducir la frecuencia de escritura hasta que se elimine el trabajo acumulado. Consúltalo en la consulta de autocorrección n.º 5. La comprobación también falla si un miembro de HA tiene registros de transacciones pendientes, por ejemplo, poco después de una conmutación por error. Si esta comprobación sigue fallando, ponte en contacto con el servicio de asistencia.
Replicación lógica No existe ningún espacio de replicación lógico. En PostgreSQL 16 y versiones anteriores, no existe ninguna suscripción lógica, incluidas las suscripciones desactivadas. Eliminar los espacios. En PostgreSQL 16 y versiones anteriores, elimine las suscripciones. En PostgreSQL 17, desactívalos. Compruébalo con las preguntas de autoevaluación 2 y 3.
Réplicas de solo lectura y clientes de replicación La implementación no tiene ninguna réplica de solo lectura asociada, y ningún cliente de replicación, salvo los miembros de alta disponibilidad, se conecta a ella. Se contabilizan las réplicas de cualquier región y estado, incluidas las réplicas que se están aprovisionando o que están desconectadas. Enumera las réplicas asociadas en la consola o con ibmcloud cdb deployment-read-replicas. Promociona o elimina cada uno de ellos y espera a que finalice cada operación. Una réplica eliminada sigue contando hasta que se elimine definitivamente, aunque ya no aparezca en la lista. Véase Réplicas de solo lectura e IPMVU. Desconecta los demás clientes de replicación. La consulta de autocomprobación 1 muestra únicamente los clientes conectados.
Transacciones preparadas No existe ninguna transacción preparada. Haga que el gestor de la aplicación o de la transacción correspondiente resuelva las transacciones preparadas y evite que se inicien otras nuevas hasta que finalice la actualización. No los publiques ni los reviertas solo para superar la comprobación. Consúltalo en la consulta de autocorrección n.º 4.
Exportación de esquemas El esquema de cada base de datos se exporta sin errores. Una exportación que agote el tiempo de espera o se quede sin espacio de bloqueo no falla esta comprobación. Prueba la actualización en un entorno de prueba que hayas restaurado a partir de una copia de seguridad reciente. Esta comprobación no verifica si la versión de destino puede recrear el esquema, por lo que también hay que resolver las condiciones que las comprobaciones previas no detectan. Si esta comprobación sigue fallando, ponte en contacto con el servicio de asistencia.
Compatibilidad con actualizaciones Las comprobaciones de compatibilidad de la actualización de PostgreSQL se superan en el servidor principal y en todos los miembros de alta disponibilidad. Finaliza la preparación de la prórroga, incluida la comprobación pgRouting. En PostgreSQL 17, mantén un máximo de 10 suscripciones. Consúltalas en las preguntas de autoevaluación 6, 8, 9 y 10.

Condiciones que las comprobaciones previas no detectan

Las comprobaciones previas no detectan las siguientes condiciones. Algunos de ellos provocan que la actualización falle después de que se bloqueen las operaciones de escritura. Si la causa está en el esquema, como una función o el nombre de una base de datos, todos los reintentos fallarán de la misma manera hasta que se resuelva el problema. Otras condiciones hacen que el servicio copie toda la base de datos a los miembros de alta disponibilidad, lo que mantiene las escrituras bloqueadas durante mucho más tiempo, o provocan que la actualización falle una vez reanudadas las escrituras. Un fallo en la fase de conversión o de reinicio también puede provocar que los miembros de alta disponibilidad (HA) permanezcan detenidos hasta que el servicio de asistencia los reinicie. Resuelve o planifica cada situación antes de enviar la actualización.

Condiciones que las comprobaciones previas no detectan
Condición Efecto Qué hacer
Una base de datos contiene una tabla UNLOGGED. Se recrea cada miembro de HA y se restablecen los contenidos UNLOGGED. Consúltalo en la consulta de autocomprobación n.º 11. Véanse las tablas UNLOGGED y secuencias.
La implementación ejecuta PostgreSQL 16 o 17, y las tablas han crecido debido a operaciones masivas o a numerosas inserciones o actualizaciones simultáneas. Se han reconstruido los miembros de HA. Planifica la ventana de mantenimiento y el espacio en disco necesario para una reconstrucción. Consulte Disponibilidad durante una actualización.
Un miembro de datos utiliza aproximadamente la mitad de su disco, o incluso más, cuando se reconstruyen los miembros de alta disponibilidad (HA). La reconstrucción se queda sin espacio. Las operaciones de escritura pueden permanecer bloqueadas durante horas antes de que la tarea falle. Antes de enviar la actualización, amplíe la capacidad del disco hasta que cada miembro de datos utilice considerablemente menos del 50 % de su espacio en disco disponible.
Un índice, una clave de partición, una columna generada almacenada o las estadísticas ampliadas utilizan una función LANGUAGE sql con un cuerpo de cadena que nombra objetos externos pg_catalog sin su esquema. En un índice, nombrar el esquema ibm_extension tiene el mismo efecto. La conversión falla. Consúltalo en la consulta de autocorrección n.º 12. Consulta las funciones SQL en índices, claves de partición y columnas generadas.
Un índice o una columna generada almacenada utiliza la versión earthdistance 1.1. La conversión falla. Consúltalo en la consulta de autocorrección n.º 13. Consulte earthdistance.
Una vista, un agregado o una función con un cuerpo conforme al estándar SQL utiliza un nombre de sistema que se ha eliminado en la versión de destino. O bien, una función, un rol o una configuración de la base de datos utiliza un parámetro eliminado. La conversión falla. Consulta las preguntas de autoevaluación 7 y 14. Consulte Objetos que utilizan nombres de sistema eliminados.
anon Se ha instalado la versión 2. La conversión falla. Finaliza la preparación anon.
El nombre de una base de datos contiene una comilla simple ('), una barra invertida (``), un signo igual (=), un salto de línea o un retorno de carro. La actualización falla, en algunos casos después de que se bloqueen las operaciones de escritura. Consúltalo en la pregunta de autoevaluación n.º 15. Cambia el nombre de la base de datos y actualiza tus cadenas de conexión.
Las bases de datos contienen muchos miles de tablas y secuencias o, en PostgreSQL 14 y 15, vistas. La conversión se queda sin espacio de bloqueo y falla. Compruébalo con la consulta de autocomprobación n.º 16 y aumenta el valor si max_locks_per_transaction la consulta indica que es necesario.
La implementación cuenta con un gran número de bases de datos, tablas u objetos de gran tamaño. La conversión supera el tiempo límite. La tarea falla o permanece en curso mientras la base de datos no está disponible. Cuenta las tablas y los objetos de gran tamaño con la consulta de autocomprobación 16. Prueba en un entorno de pruebas que hayas restaurado a partir de una copia de seguridad reciente del entorno de producción. Si la prueba falla, ponte en contacto con el servicio de asistencia.
La actividad de escritura es elevada cuando se inicia la actualización o cuando hay muchos registros de transacciones pendientes de archivarse. Una vez que se inicia el modo de solo lectura, los miembros de alta disponibilidad y el archivado del registro de transacciones disponen de solo unos minutos para ponerse al día. Una lista de tareas pendientes que supera la comprobación previa puede tardar más tiempo en archivarse, lo que provoca que la actualización falle. Mantén baja la carga desde el momento en que comience la actualización hasta que se reanuden las escrituras, y ejecuta la operación en VACUUM tablas cargadas recientemente antes de la actualización. Comprueba el retraso en la replicación utilizando la consulta de Disponibilidad durante una actualización y comprueba el archivado utilizando la consulta de autocomprobación 5.
Las operaciones de escritura continúan tras el inicio del modo de solo lectura, por ejemplo, debido a anulaciones en modo de solo lectura, comandos de mantenimiento, trabajos pg_cron en ejecución o suscripciones activadas en PostgreSQL 17. Es posible que los miembros de HA y el proceso de archivado no se sincronicen a tiempo, lo que provocaría que la actualización fallara. Detén a estos autores antes de enviar la actualización, tal y como se describe en Disponibilidad durante una actualización.
Un cliente prepara una transacción tras las comprobaciones previas. Sigue PREPARE TRANSACTION funcionando en modo de solo lectura. La actualización falla mientras las operaciones de escritura están bloqueadas. Una transacción que se prepare poco antes de que PostgreSQL se detenga puede provocar que la conversión falle. Detenga los clientes que utilicen la confirmación en dos fases hasta que la tarea aparezca como Completada. Consúltalo en la consulta de autocorrección n.º 4.
Un cliente de replicación se conecta durante la actualización. La franja horaria que se crea no se mantiene, y la actualización puede fallar o bloquearse mientras la base de datos no esté disponible. Mantenga los clientes de replicación desconectados hasta que la tarea aparezca como Completada. Compruébalo con las preguntas de autoevaluación 1 y 2.
Se ejecuta una carga masiva continua una vez que se reanudan las escrituras. La tarea falla tras reanudarse las operaciones de escritura, y la implementación ejecuta la versión de destino hasta que el servicio de soporte complete la actualización. Evita las cargas masivas hasta que la tarea aparezca como Completada.
La configuración synchronous_commit de la implementación es on. Una actualización fallida puede dejar todas las bases de datos en modo de solo lectura hasta que el servicio de asistencia técnica restablezca la implementación. Cámbialo por local, tal y como se describe en Antes de empezar.
Si actualizas de PostgreSQL 16 o una versión anterior a la 17 o posterior, y un índice, una vista materializada o unas estadísticas ampliadas utilizan una función sin una search_path configuración. Tras la actualización, ANALYZE, REINDEX, CLUSTER, VACUUM FULL, y REFRESH MATERIALIZED VIEW pueden fallar para estos objetos. Consúltalo en la consulta de autocorrección n.º 17. Consulta las funciones SQL en índices, claves de partición y columnas generadas.

No modifique los esquemas, las extensiones, las bases de datos, los espacios de replicación lógica ni las suscripciones entre el momento de enviar la actualización y la finalización de la tarea.

Comprueba tú mismo si estás preparado

Ejecuta las siguientes consultas como usuario admin con antes psql de enviar la actualización. Funcionan con PostgreSQL, desde la versión 14 hasta la 18. Las consultas del 1 al 7 y la consulta 15 abarcan toda la implementación, así que ejecútalas una vez en cualquier base de datos. Ejecuta las demás consultas en cada base de datos.

  1. Conexiones de replicación. Se espera una fila por cada miembro de alta disponibilidad (HA), que es el número de miembros de datos menos uno, cada uno con el estado streaming. Cualquier otra fila es una réplica de solo lectura u otro cliente de replicación. Una fila con el nombre significa pg_basebackup que el servicio está copiando la base de datos a un miembro de alta disponibilidad (HA) o a una réplica de solo lectura. Espera a que termine la copia y, a continuación, vuelve a ejecutar la consulta.

    SELECT application_name, client_addr, state
    FROM pg_catalog.pg_stat_replication
    ORDER BY application_name;
    
  2. Espacios de replicación lógica. No se esperan errores.

    SELECT slot_name, plugin, database, active
    FROM pg_catalog.pg_replication_slots
    WHERE slot_type = 'logical';
    
  3. Suscripciones lógicas. En PostgreSQL 16 y versiones anteriores, no se esperan filas. En PostgreSQL 17, se espera que aparezca en f la columna subenabled de cada fila.

    SELECT d.datname AS database_name, s.subname, s.subenabled
    FROM pg_catalog.pg_subscription AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.subdbid;
    
  4. Transacciones preparadas. No se esperan errores.

    SELECT gid, owner, database, prepared
    FROM pg_catalog.pg_prepared_xacts;
    
  5. Archivado del registro de transacciones. Se espera last_failed_time que esté vacío o sea anterior a last_archived_time, y waiting_files que sea 0 o cercano a 0. Una lista de tareas pendientes que supere la comprobación previa puede seguir siendo demasiado grande para archivarla una vez que comience el modo de solo lectura.

    SELECT failed_count, last_failed_time, last_archived_time
    FROM pg_catalog.pg_stat_archiver;
    
    SELECT count(*) AS waiting_files,
           pg_catalog.pg_size_pretty(count(*) * pg_catalog.pg_size_bytes(pg_catalog.current_setting('wal_segment_size'))) AS waiting_size
    FROM pg_catalog.pg_ls_archive_statusdir()
    WHERE name LIKE '%.ready';
    
  6. Configuración de la conexión a la base de datos. No se esperan errores. Elimina una base de datos de la lista cuyo datconnlimit sea -2, ya que no es válida. Para cualquier otra base de datos de la lista, permite las conexiones o elimínala. Si la consulta no aparece en la lista template0, ponte en contacto con el servicio de asistencia.

    SELECT datname, datallowconn, datconnlimit
    FROM pg_catalog.pg_database
    WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2))
       OR (datname = 'template0' AND datallowconn);
    
  7. Configuración de roles y bases de datos. Asegúrate de que todos los parámetros de existan setconfig en la versión de destino. Restablezca un parámetro que la versión de destino haya eliminado o renombrado, y configure su sustituto tras la actualización. Esto también se aplica a los parámetros definidos por las extensiones, cuyos nombres contienen un punto. Asegúrate de que ningún rol tenga default_transaction_read_only un valor falso, como off, false, no, o 0. Anota cada base de datos que tenga esta configuración default_transaction_read_only, ya que la actualización restablece este valor. La consulta de autocomprobación n.º 14 comprueba la configuración de las funciones.

    SELECT r.rolname AS role_name, d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    LEFT JOIN pg_catalog.pg_roles AS r ON r.oid = s.setrole
    LEFT JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase;
    
  8. Tipos de datos de columna que PostgreSQL no puede actualizar. No se esperan errores. La consulta también incluye columnas de tipos compuestos del sistema, así como de dominios, matrices, tipos compuestos y rangos que se basan en estos tipos. La columna base_type muestra el tipo de bloque que impide la actualización. El tipo aclitem solo admite actualizaciones de PostgreSQL 14 o 15 a la versión 16 o posteriores.

    WITH RECURSIVE problem_types (type_oid, base_type) AS (
      SELECT t.oid, t.typname::text
      FROM pg_catalog.pg_type AS t
      WHERE t.typnamespace = 'pg_catalog'::pg_catalog.regnamespace
        AND t.typname IN ('regcollation', 'regconfig', 'regdictionary', 'regnamespace',
                          'regoper', 'regoperator', 'regproc', 'regprocedure', 'aclitem')
      UNION ALL
      SELECT t.oid, 'system composite type ' || t.oid::pg_catalog.regtype::text
      FROM pg_catalog.pg_type AS t
      LEFT JOIN pg_catalog.pg_namespace AS n ON n.oid = t.typnamespace
      WHERE t.typtype = 'c'
        AND (t.oid < 16384 OR n.nspname = 'information_schema')
      UNION ALL
      SELECT derived.type_oid, derived.base_type
      FROM (
        WITH found AS (SELECT type_oid, base_type FROM problem_types)
        SELECT t.oid AS type_oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'd' AND t.typbasetype = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'b' AND t.typelem = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_class AS c ON c.reltype = t.oid
        JOIN pg_catalog.pg_attribute AS a ON a.attrelid = c.oid AND NOT a.attisdropped
        JOIN found AS f ON a.atttypid = f.type_oid
        WHERE t.typtype = 'c'
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_range AS r ON r.rngtypid = t.oid
        JOIN found AS f ON r.rngsubtype = f.type_oid
        WHERE t.typtype = 'r'
      ) AS derived
    )
    SELECT DISTINCT n.nspname AS schema_name, c.relname AS relation_name, a.attname AS column_name,
           a.atttypid::pg_catalog.regtype AS data_type, p.base_type
    FROM pg_catalog.pg_attribute AS a
    JOIN pg_catalog.pg_class AS c ON c.oid = a.attrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    JOIN problem_types AS p ON p.type_oid = a.atttypid
    WHERE a.attnum > 0
      AND NOT a.attisdropped
      AND c.relkind IN ('r', 'm', 'i')
      AND n.nspname NOT IN ('pg_catalog', 'information_schema')
      AND n.nspname !~ '^pg_toast_temp_|^pg_temp_'
    ORDER BY 1, 2, 3;
    
  9. Columnas heredadas que no tienen una restricción NOT NULL que sí tiene su tabla principal. No se esperan errores. Para fijar una columna de la lista, el propietario de la tabla ejecuta ALTER TABLE <table_name> ALTER COLUMN <column_name> SET NOT NULL;.

    SELECT n.nspname AS schema_name, c.relname AS table_name, child.attname AS column_name
    FROM pg_catalog.pg_inherits AS i
    JOIN pg_catalog.pg_attribute AS child ON child.attrelid = i.inhrelid
    JOIN pg_catalog.pg_attribute AS parent
      ON parent.attrelid = i.inhparent AND parent.attname = child.attname
    JOIN pg_catalog.pg_class AS c ON c.oid = i.inhrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE parent.attnum > 0
      AND parent.attnotnull
      AND NOT child.attnotnull
      AND NOT child.attisdropped;
    
  10. Extensiones instaladas. Finalizar la preparación de la ampliación. A continuación, comprueba que todas las extensiones restantes estén disponibles en la versión de destino, por ejemplo, en una implementación de prueba de dicha versión.

    SELECT extname, extversion
    FROM pg_catalog.pg_extension
    ORDER BY extname;
    
  11. UNLOGGED tablas y secuencias. Su contenido no se conserva tras la actualización, y una tabla incluida hace que el servicio tenga que reconstruir todos los miembros de alta disponibilidad. Antes de actualizar, consulta las tablas UNLOGGED y secuencias.

    SELECT n.nspname AS schema_name, c.relname AS relation_name, c.relkind
    FROM pg_catalog.pg_class AS c
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE c.relpersistence = 'u'
      AND c.relkind IN ('r', 'S');
    
  12. Funciones SQL que pueden provocar que la conversión falle. No se esperan errores. La consulta enumera las funciones LANGUAGE sql con un cuerpo de cadena que utilizan un índice, un predicado de índice parcial, una clave de partición, una columna generada almacenada o estadísticas ampliadas. Sigue las llamadas a través de operadores, restricciones de comprobación de dominios y funciones con un cuerpo conforme al estándar SQL. Para cada función de la lista, consulta las funciones SQL en índices, claves de partición y columnas generadas.

    WITH RECURSIVE uses (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid,
             CASE WHEN c.relkind = 'p' THEN 'partition key of ' ELSE 'index ' END
               || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
      WHERE c.relkind IN ('i', 'I') OR (c.relkind = 'p' AND d.objsubid = 0)
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attrelid = ad.adrelid
       AND a.attnum = ad.adnum
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attribute AS a
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND a.attrelid = d.objid
       AND a.attnum = d.objsubid
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid, 'statistics ' || s.stxname || ' on ' || s.stxrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s
        ON d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
       AND s.oid = d.objid
    ), used (fn, used_by) AS (
      SELECT x.fn, u.used_by
      FROM uses AS u
      CROSS JOIN LATERAL (
        SELECT u.refobjid AS fn
        WHERE u.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE u.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = u.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE u.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = u.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
       AND NOT p.prosecdef
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT u.fn::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname = 'sql'
      AND p.prosqlbody IS NULL
      AND p.proconfig IS NULL
      AND NOT p.prosecdef
      AND p.pronamespace <> 'pg_catalog'::pg_catalog.regnamespace
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    
  13. Índices y columnas generadas almacenadas que utilizan la versión earthdistance 1.1, directamente o a través de funciones con un cuerpo conforme al estándar SQL. No se esperan errores. Para cada elemento de la lista, consulta earthdistance.

    WITH RECURSIVE used (fn, via, used_by) AS (
      SELECT d.refobjid, d.refobjid, 'index ' || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
       AND c.relkind IN ('i', 'I')
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      LEFT JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attgenerated = 's'
       AND ((a.attrelid = ad.adrelid AND a.attnum = ad.adnum)
            OR (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                AND a.attrelid = d.objid
                AND a.attnum = d.objsubid))
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, u.via, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
       AND d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
    )
    SELECT e.extversion, u.via::pg_catalog.regprocedure AS used_function, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_depend AS m
      ON m.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
     AND m.objid = u.fn
     AND m.refclassid = 'pg_catalog.pg_extension'::pg_catalog.regclass
     AND m.deptype = 'e'
    JOIN pg_catalog.pg_extension AS e ON e.oid = m.refobjid
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE e.extname = 'earthdistance'
      AND e.extversion IN ('1.0', '1.1')
      AND l.lanname = 'sql'
      AND p.proconfig IS NULL
    ORDER BY 2, 3;
    
  14. Vistas, vistas materializadas, agregados y funciones que utilizan nombres del catálogo del sistema o parámetros de configuración que se han eliminado en una versión posterior de PostgreSQL. La columna removed_in muestra la primera versión sin el nombre. No se esperan filas con una versión removed_in igual o inferior a la versión objetivo. Un nombre puede coincidir con texto que no sea una referencia del catálogo, por lo que debes revisar cada objeto de la lista. Consulte Objetos que utilizan nombres de sistema eliminados.

    WITH removed (relation_name, identifier, removed_in) AS (
      VALUES (NULL, 'pg_is_in_backup', 15), (NULL, 'pg_backup_start_time', 15),
             (NULL, 'pg_start_backup', 15), (NULL, 'pg_stop_backup', 15),
             ('pg_database', 'datlastsysoid', 15),
             (NULL, 'force_parallel_mode', 16),
             ('pg_stat_bgwriter', 'checkpoints_timed', 17), ('pg_stat_bgwriter', 'checkpoints_req', 17),
             ('pg_stat_bgwriter', 'checkpoint_write_time', 17), ('pg_stat_bgwriter', 'checkpoint_sync_time', 17),
             ('pg_stat_bgwriter', 'buffers_checkpoint', 17), ('pg_stat_bgwriter', 'buffers_backend', 17),
             ('pg_stat_bgwriter', 'buffers_backend_fsync', 17),
             (NULL, 'pg_stat_get_bgwriter_timed_checkpoints', 17),
             (NULL, 'pg_stat_get_bgwriter_requested_checkpoints', 17),
             (NULL, 'pg_stat_get_checkpoint_write_time', 17), (NULL, 'pg_stat_get_checkpoint_sync_time', 17),
             (NULL, 'pg_stat_get_bgwriter_buf_written_checkpoints', 17),
             (NULL, 'pg_stat_get_buf_written_backend', 17), (NULL, 'pg_stat_get_buf_fsync_backend', 17),
             ('pg_stat_progress_vacuum', 'max_dead_tuples', 17),
             ('pg_stat_progress_vacuum', 'num_dead_tuples', 17),
             ('pg_database', 'daticulocale', 17), ('pg_collation', 'colliculocale', 17),
             ('element_types', 'domain_default', 17),
             (NULL, 'interval_accum', 17), (NULL, 'interval_accum_inv', 17), (NULL, 'interval_combine', 17),
             ('pg_stat_wal', 'wal_write', 18), ('pg_stat_wal', 'wal_sync', 18),
             ('pg_stat_wal', 'wal_write_time', 18), ('pg_stat_wal', 'wal_sync_time', 18),
             ('pg_stat_io', 'op_bytes', 18), ('pg_backend_memory_contexts', 'parent', 18),
             ('pg_attribute', 'attcacheoff', 18)
    ), definitions (object_name, definition) AS (
      SELECT 'view ' || c.oid::pg_catalog.regclass::text, pg_catalog.pg_get_viewdef(c.oid)
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind IN ('v', 'm')
        AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'function ' || p.oid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', pg_catalog.pg_get_function_sqlbody(p.oid),
                                  pg_catalog.array_to_string(p.proconfig, ' '))
      FROM pg_catalog.pg_proc AS p
      WHERE (p.prosqlbody IS NOT NULL OR p.proconfig IS NOT NULL)
        AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'aggregate ' || a.aggfnoid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', a.aggtransfn, a.aggfinalfn, a.aggcombinefn,
                                  a.aggmtransfn, a.aggminvtransfn, a.aggmfinalfn)
      FROM pg_catalog.pg_aggregate AS a
      JOIN pg_catalog.pg_proc AS p ON p.oid = a.aggfnoid
      WHERE p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
    )
    SELECT d.object_name, r.identifier, r.removed_in
    FROM definitions AS d
    JOIN removed AS r
      ON d.definition ~ ('\m' || r.identifier || '\M')
     AND (r.relation_name IS NULL OR d.definition ~ ('\m' || r.relation_name || '\M'))
    ORDER BY 3, 1, 2;
    
  15. Nombres de bases de datos que la actualización no puede utilizar. No se esperan errores. Para corregir una base de datos de la lista, su propietario debe conectarse a otra base de datos y ejecutar ALTER DATABASE "<database_name>" RENAME TO <new_name>; mientras no haya sesiones conectadas a la base de datos cuyo nombre se va a cambiar. El propietario también debe tener el atributo CREATEDB. A continuación, actualice todas las aplicaciones que se conecten a la base de datos.

    SELECT datname
    FROM pg_catalog.pg_database
    WHERE pg_catalog.strpos(datname, '''') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(92)) > 0
       OR pg_catalog.strpos(datname, '=') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(10)) > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(13)) > 0
    ORDER BY datname;
    
  16. Relaciones que bloquea la actualización, objetos de gran tamaño y la capacidad de bloqueo de la implementación. Suma los valores locked_relations de las cuatro bases de datos con los valores más altos. En PostgreSQL 14 y 15, locked_relations incluye vistas y vistas materializadas, ya que la actualización también las bloquea. Si el total supera lock_capacity, aumenta max_locks_per_transaction hasta que supere lock_capacity el total. El cambio reinicia la base de datos, así que realícelo antes de enviar la actualización. Las tablas numerosas o los objetos de gran tamaño también alargan el proceso de conversión, así que prueba la actualización con tu esquema y tus datos reales.

    SELECT pg_catalog.current_database() AS database_name,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_class AS c
            WHERE (c.relkind IN ('r', 'p', 'S')
                   OR (c.relkind IN ('v', 'm')
                       AND pg_catalog.current_setting('server_version_num')::integer < 160000))
              AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                         'information_schema'::pg_catalog.regnamespace)) AS locked_relations,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_largeobject_metadata) AS large_objects,
           pg_catalog.current_setting('max_locks_per_transaction')::integer
             * (pg_catalog.current_setting('max_connections')::integer
                + pg_catalog.current_setting('max_prepared_transactions')::integer) AS lock_capacity;
    
  17. Funciones sin un search_path parámetro que utilizan las vistas indexadas, las vistas materializadas y las estadísticas ampliadas. La consulta incluye llamadas a operadores, restricciones de comprobación de dominios y funciones, con un cuerpo conforme al estándar SQL. Ejecuta esta consulta si actualizas de PostgreSQL 16 o una versión anterior a PostgreSQL 17 o una versión posterior. Una función listada cuyo cuerpo nombra objetos externos sin pg_catalog su esquema hace que comandos de mantenimiento fallen tras la actualización. Una función solo queda exenta de esta restricción si su cuerpo, y todas las funciones a las que llama, identifican cada objeto externo pg_catalog mediante su esquema. Para cada una de las demás funciones enumeradas, su propietario añade un search_path parámetro, tal y como se describe en las funciones SQL en índices, claves de partición y columnas generadas.

    WITH RECURSIVE refreshed (relid, used_by) AS (
      SELECT c.oid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind = 'm'
      UNION
      SELECT v.oid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
       AND d.refclassid = 'pg_catalog.pg_class'::pg_catalog.regclass
      JOIN pg_catalog.pg_class AS v ON v.oid = d.refobjid AND v.relkind = 'v'
    ), refs (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c ON c.oid = d.objid AND c.relkind IN ('i', 'I')
      WHERE d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
      UNION
      SELECT d.refclassid, d.refobjid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
      UNION
      SELECT d.refclassid, d.refobjid, s.stxrelid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s ON s.oid = d.objid
      WHERE d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
    ), used (fn, used_by) AS (
      SELECT x.fn, r.used_by
      FROM refs AS r
      CROSS JOIN LATERAL (
        SELECT r.refobjid AS fn
        WHERE r.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE r.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = r.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE r.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = r.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND NOT EXISTS (SELECT 1
                       FROM pg_catalog.unnest(p.proconfig) AS setting
                       WHERE setting LIKE 'search\_path=%')
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT p.oid::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname NOT IN ('c', 'internal')
      AND p.prosqlbody IS NULL
      AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                 'information_schema'::pg_catalog.regnamespace)
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.unnest(p.proconfig) AS setting
                      WHERE setting LIKE 'search\_path=%')
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    

Superar estas comprobaciones no garantiza que la actualización se realice con éxito ni que sus aplicaciones sean compatibles con la versión de destino. Solo en un ensayo en un entorno de prueba se ejecuta la conversión completa.

Planificación del periodo de actualización

Utiliza tu ensayo en el entorno de prueba para calcular una ventana de mantenimiento. El tiempo de conversión depende principalmente del número de bases de datos y objetos. La reconstrucción de un miembro de alta disponibilidad depende del tamaño de la base de datos. La carga de trabajo y el volumen del registro de transacciones afectan a las comprobaciones y a la puesta al día. Hay que tener en cuenta el tiempo total que lleva la tarea de actualización, no solo el tiempo durante el que se bloquean las operaciones de escritura.

La opción Inicio de caducidad establece la hora más tardía en la que puede iniciarse una actualización en cola. El valor predeterminado es de 5 minutos tras la solicitud, y se puede configurar con hasta 24 horas de antelación. La ejecución de operaciones, como una copia de seguridad, y las solicitudes en cola anteriores retrasan el inicio. Si la actualización no se inicia antes de la hora de caducidad, no se ejecuta y su tarea aparece como Caducada. La caducidad no detiene una actualización que ya se haya iniciado. Por ejemplo, una solicitud en cola caduca a las 22:30 UTC. Una tarea que comienza a las 22:25 UTC puede prolongarse más allá de esa hora.

Mientras se ejecuta la actualización, las demás solicitudes de implementación quedan en espera hasta que esta finalice. Entre ellos se incluyen el escalado manual y automático, los cambios de configuración, los cambios en los usuarios y las contraseñas, los cambios en las direcciones IP permitidas y las copias de seguridad. No elimines la implementación mientras la tarea de actualización esté en cola o en ejecución.

No cree réplicas de solo lectura hasta que la tarea haya finalizado. El servicio no bloquea este tipo de solicitudes. Si se crea una, la actualización puede no superar las comprobaciones previas, o la nueva réplica no podrá replicarse desde la implementación actualizada. Elimina dicha réplica y crea una nueva una vez finalizada la tarea.

Actualización en la IU

  1. Crea y verifica una copia de seguridad bajo demanda. La actualización no tarda ni un segundo.
  2. En la página Descripción general de la implementación, haz clic en Actualizar versión principal.
  3. En el paso Instrucciones, revise las instrucciones, seleccione He leído las instrucciones y estoy listo para continuar con la actualización y haga clic en Siguiente. Para saber cuándo no están disponibles las operaciones de lectura y escritura, consulta Disponibilidad durante una actualización.
  4. En Actualizar a la versión, selecciona la versión de destino. Si hay más de un destino disponible, la lista selecciona el más reciente de forma predeterminada. La nota sobre las réplicas de lectura de este paso está desactualizada. La actualización no supera las comprobaciones previas mientras haya alguna réplica de solo lectura asociada a la implementación, por lo que debes ascender o eliminar todas las réplicas antes de actualizar.
  5. En Plazo de caducidad para iniciar la actualización, selecciona cuánto tiempo puede esperar la solicitud antes de iniciarse. El valor predeterminado es de 5 minutos.
  6. Pulse Actualizar. Mientras la solicitud está en espera o se está ejecutando, la fila Versión de la página Resumen muestra Actualización en cola o Actualización en curso.
  7. Supervisa la tarea en Tareas recientes. En cuanto se reanuden las operaciones de escritura, actualice las estadísticas tal y como se describe en Después de la actualización. Cuando la tarea aparezca como Completada, realiza los pasos restantes de esa sección. Si aparece Fallido, consulta la sección Solución de problemas. Si aparece Caducado, significa que la actualización no se ha iniciado, y puedes volver a enviarla con una fecha de caducidad posterior.

Actualización a través de la API

Envía una solicitud PATCH al punto final /deployments/{id}/version. Establece la versión principal de version destino y configura la fecha de caducidad inicial con el parámetro de consulta expiration_datetime:

curl -X PATCH \
  'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version?expiration_datetime=<EXPIRATION_TIME>' \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"version": "18"}'

Sustituya por <EXPIRATION_TIME> una hora UTC en formato ISO 8601, como 2026-11-03T22:30:00Z, entre 5 minutos y 24 horas después de la solicitud. Si se omite expiration_datetime, la solicitud caducará si no se inicia en un plazo de 5 minutos.

Una solicitud realizada con éxito devuelve una tarea. Una solicitud aceptada no equivale a una actualización completada. Utiliza el ID de la tarea con Obtener información sobre una tarea para supervisar la actualización. Para ver una lista de los destinos disponibles, utiliza la función Descubrir información sobre capacidades de una implementación con la capacidad versions. Para conocer todos los parámetros, consulta la referencia de la API.

Actualización a través de la CLI

Utilice la versión 0.20.0 o posterior del complemento CLI de Cloud Databases. Establece el plazo de caducidad inicial con --expire-in o --expire-at, entre 5 minutos y 24 horas tras la solicitud. El valor predeterminado es de 5 minutos.

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait

Sin --nowait, el comando espera hasta que la tarea se complete o falle. No devuelve ningún resultado si la actualización caduca antes de que comience, así que utilízala en --nowait scripts. Con --nowait, el comando devuelve un resultado una vez que el servicio acepta la solicitud. Supervisa la tarea con deployment-tasks-list:

ibmcloud cdb deployment-tasks-list <NAME|CRN>

Para todos los parámetros, ejecute ibmcloud cdb deployment-version-upgrade --help.

Actualización mediante Terraform

Utilice el proveedor de Terraform IBM Cloud®, versión 1.79.2 o posterior. Establece un version objetivo viable, revisa el plan y ponlo en práctica. El plan fracasará si el destino no está disponible para una actualización in situ.

Establezca el tiempo de espera de actualización del recurso de forma que sea suficiente para completar toda la actualización y que sea, como mínimo, de 5 minutos. El proveedor también utiliza este tiempo de espera, de hasta 24 horas, como fecha de inicio de la caducidad. Por lo tanto, una actualización en cola puede iniciarse en cualquier momento hasta que expire el tiempo de espera. Aplica el cambio cuando no haya ninguna copia de seguridad ni ninguna otra operación en ejecución o en cola, para que la actualización comience de inmediato. Si se agota el tiempo de espera de la aplicación una vez iniciada la actualización, esta continúa. Si la actualización sigue en cola cuando se agota el tiempo de espera, caduca y no se ejecuta. Espera a que la tarea finalice antes de volver terraform apply a ejecutar o terraform plan.

Si la tarea de actualización falla, sigue las instrucciones de resolución de problemas antes de volver terraform apply a ejecutarla. Terraform vuelve a enviar la actualización cada vez que la implementación sigue indicando la versión de origen.

Tras una actualización fuera de Terraform, configura version a la nueva versión o elimina version de la configuración. Las actualizaciones ajenas a Terraform incluyen actualizaciones en la interfaz de usuario, la CLI o la API, así como una actualización forzada. Hasta que actualices la configuración, todos los terraform plan y que terraform apply incluyan la implementación fallarán, lo que impedirá que se realicen cambios en otros recursos de la misma configuración. El error es similar a o Version 14 is not a valid upgrade version No available upgrade versions for version 18.

El argumento version_upgrade_skip_backup no está admitido en PostgreSQL. Para obtener más información, consulta la referencia de recursos de la base de datos.

Tras la actualización

En cuanto se reanuden las operaciones de escritura, asegúrate de que las estadísticas del optimizador estén completas. No espere a que se complete la tarea. Las operaciones de escritura se reanudan cuando SHOW default_transaction_read_only; se inicia off una nueva sesión. En cada base de datos, la siguiente consulta muestra las tablas y vistas materializadas que carecen de estadísticas. Ejecuta ANALYZE <table_name>; para cada relación de la lista. Si el usuario no tiene permiso para analizar una relación, ejecute el comando como propietario de la relación. Al analizar una tabla particionada, también se analizan sus particiones.

SELECT c.oid::pg_catalog.regclass AS relation_name
FROM pg_catalog.pg_class AS c
WHERE c.relkind IN ('r', 'm', 'p')
  AND c.reltuples < 0
  AND NOT c.relispartition
  AND c.relpersistence <> 't'
  AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                             'information_schema'::pg_catalog.regnamespace)
  AND NOT EXISTS (SELECT 1
                  FROM pg_catalog.pg_depend AS e
                  WHERE e.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                    AND e.objid = c.oid
                    AND e.deptype = 'e');

En PostgreSQL 17 y versiones posteriores, ANALYZE puede fallar con un error como function ... does not exist. En ese caso, corrija la función que aparece en la consulta 17 de la autoverificación y ANALYZE vuelva a ejecutarla. Una consulta ANALYZE que abarca toda la base de datos y que se detiene debido a un error no analiza las tablas restantes. En PostgreSQL 18, analiza también cada tabla que tenga objetos de estadísticas, tal y como se enumeran con el comando psql \dX, y cada tabla que contenga columnas PostGIS, ya que la actualización no transfiere estas estadísticas.

Una vez que la tarea aparezca como Completada:

  1. Comprueba que la versión de la implementación que aparece en la consola o en la API coincida con la versión de destino y que la SHOW server_version; devuelva. Ejecuta la consulta de autocomprobación 1 y comprueba que todos los miembros de HA estén transmitiendo datos. Comprueba también que se hayan reanudado las operaciones de escritura en todas las bases de datos: la siguiente consulta no devuelve ninguna fila. Si falta un miembro de HA, queda pg_basebackup una fila denominada o la consulta incluye una base de datos, ponte en contacto con el servicio de asistencia.

    SELECT d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase
    WHERE s.setrole = 0
      AND d.datallowconn
      AND NOT d.datistemplate
      AND EXISTS (SELECT 1
                  FROM pg_catalog.unnest(s.setconfig) AS c(setting)
                  WHERE c.setting LIKE 'default_transaction_read_only=%');
    
  2. Actualizar las extensiones. La actualización mantiene cada extensión en la versión en la que está instalada. En cada base de datos, enumera las extensiones que tienen una versión más reciente y actualiza cada una de ellas:

    SELECT name, installed_version, default_version
    FROM pg_catalog.pg_available_extensions
    WHERE installed_version <> default_version;
    
    ALTER EXTENSION <extension_name> UPDATE;
    

    Si has actualizado desde PostgreSQL 14, 15 o 16 a PostgreSQL 17 o una versión posterior, la actualización renombra pg_stat_statements sus columnas blk_write_time blk_read_time y a shared_blk_read_time y shared_blk_write_time. Actualiza las consultas que leen estas columnas.

  3. Restablecer las extensiones y el enmascaramiento tal y como se describe en la preparación. Vuelve a cargar las tablas UNLOGGED a partir del contenido que has exportado. Establece cada secuencia UNLOGGED más allá de los valores en uso, por ejemplo, con SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));. Vuelve a crear los espacios de replicación lógica, las suscripciones y las réplicas de solo lectura que has eliminado, y activa las suscripciones que has desactivado. Vuelva a conectar a los usuarios y resincronice los datos antes de reanudar las aplicaciones dependientes.

  4. Si has configurado default_transaction_read_only para una base de datos, vuelve a configurarlo. La actualización restablece esta configuración en todas las bases de datos, de modo que estas vuelven a aceptar operaciones de escritura.

  5. Comprueba que se haya completado la copia de seguridad posterior a la actualización. Copia toda la base de datos, por lo que puede tardar varias horas. Si necesitas una recuperación a un momento determinado para los cambios realizados tras la actualización, mantén en pausa las operaciones de escritura de la aplicación hasta entonces.

  6. Si has actualizado de PostgreSQL 14 o 15 a PostgreSQL 16 o una versión posterior, ejecuta la consulta de roles que se indica en Problemas con los privilegios de roles durante las actualizaciones de versión. Otorga los roles indicados antes de reanudar las tareas que gestionan dichos roles.

  7. Si Terraform gestiona la implementación y has actualizado fuera de Terraform, configúralo version en la nueva versión o elimínalo, tal y como se describe en Actualización a través de Terraform.

  8. Reanuda los procesos de la aplicación y las tareas programadas que habías pausado. Restaura los ajustes que modificaste para la actualización, como synchronous_commit.

  9. Recompila los objetos que dependen de datos Unicode, ya que las versiones más recientes de PostgreSQL utilizan datos Unicode más recientes:

    • A menos que hayas actualizado de PostgreSQL 16 a PostgreSQL 17, comprueba los índices, las vistas materializadas, las restricciones de validación y las claves de partición cuyas expresiones utilicen normalize() o is_normalized(). Solo se ve afectado el texto que contenga caracteres nuevos en la versión posterior de Unicode.
    • Si has actualizado de PostgreSQL 17 a PostgreSQL 18, comprueba también los objetos que utilizan unicode_assigned(). Comprueba también los objetos que aplican expresiones regulares, ILIKE, lower(), upper(), o initcap() al texto en la configuración regional C.UTF-8 integrada. La pg_c_utf8 ordenación y las bases de datos que utilizan el proveedor de configuración regional builtin C.UTF-8 utilizan esta configuración regional.
    • Si ha actualizado a PostgreSQL 18 y una base de datos utiliza el proveedor de configuración regional builtin icu o, vuelva a generar la búsqueda de texto completo y los índices pg_trgm.

    Ejecuta REINDEX INDEX <index_name>; para cada índice afectado y REFRESH MATERIALIZED VIEW <view_name>; para cada vista materializada afectada. Asegúrate de que las filas sigan cumpliendo las restricciones de comprobación afectadas y se encuentren en las particiones correctas.

  10. Compara el comportamiento y el rendimiento de la aplicación con los resultados de tu entorno de pruebas.

Resolución de problemas

Si el servicio rechaza una solicitud, el error aparece inmediatamente. La interfaz de usuario suele mostrar el mensaje La actualización ha fallado junto con el motivo; la API devuelve el mensaje de error y la CLI muestra el error con una sugerencia. Corrige la solicitud y vuelve a enviarla.

Si la tarea aparece como Caducada, la actualización no se ha iniciado y la implementación no ha sufrido cambios. Vuelve a enviar la actualización cuando no haya ninguna otra operación en ejecución o en cola, o configura una fecha de caducidad de inicio posterior.

Una tarea que posteriormente aparece como Fallida no identifica la comprobación o el paso en el que se ha producido el fallo, y la interfaz de usuario no muestra la causa. Dependiendo del paso en el que se haya producido el fallo, la implementación puede encontrarse en uno de estos estados:

  • Sobre la versión de origen: La implementación ejecuta la versión de origen y admite operaciones de escritura. Si falla una comprobación previa, la implementación queda en este estado, y el servicio restablece el acceso de escritura tras la mayoría de los fallos que se producen durante el modo de solo lectura. Un intento fallido puede tener, aun así, efectos duraderos. Puede eliminar UNLOGGED tablas vacías old_snapshot, restablecer secuencias UNLOGGED y dejar un hueco en la cobertura de PITR. También puede restablecer la configuración default_transaction_read_only a nivel de base de datos, de modo que dichas bases de datos vuelvan a aceptar operaciones de escritura. Si se establece default_transaction_read_only en para on cualquier base de datos, un intento fallido también pone fin a todas las sesiones de los clientes, incluso cuando falla una comprobación previa.
  • Sobre la versión de destino: La implementación ejecuta la versión de destino, pero la actualización no se considerará completa hasta que el servicio de soporte la finalice. La consola y la API aún pueden mostrar la versión original. Hasta entonces, es posible que los miembros de alta disponibilidad (HA) no se ejecuten y que las copias de seguridad y el archivado de los registros de transacciones fallen. Si la consulta de autocomprobación 1 o 5 detecta un problema, detén las operaciones de escritura de la aplicación hasta que el servicio de asistencia técnica complete la actualización.
  • Afectado: La implementación permanece en modo de solo lectura o no está disponible, o bien funciona sin sus miembros de alta disponibilidad (HA), hasta que el servicio de asistencia la recupere. Un fallo en la fase de conversión o reinicio puede provocar que los miembros de alta disponibilidad (HA) permanezcan detenidos hasta que el servicio de asistencia los reinicie, incluso después de que se reanuden las operaciones de escritura.

Para identificar el estado, inicia sesión como admin y ejecuta SHOW server_version;. En cada base de datos que utilices, ejecuta SHOW default_transaction_read_only;. Ejecuta la consulta de autocomprobación 1 para confirmar que todos los miembros de HA están transmitiendo datos. Si admin no puede conectarse después de que la tarea haya fallado, por ejemplo, debido a un error de autenticación, póngase en contacto con el servicio de asistencia. La actualización no modifica tus credenciales.

Si la implementación admite escrituras, ejecuta la versión de origen y todos los miembros de alta disponibilidad (HA) están transmitiendo datos, revisa las comprobaciones previas y ejecuta las consultas de autocomprobación. Resuelve todos los elementos pendientes, realiza una copia de seguridad bajo demanda y, a continuación, vuelve a enviar la actualización. En cualquier otro caso, o si el siguiente intento también falla, ponte en contacto con el servicio de asistencia antes de volver a intentarlo o de realizar otros cambios. Incluir:

  • El CRN de la implementación y el ID de la tarea fallida. Anota el ID de la tarea cuando esta falle, ya que las listas de tareas solo muestran las tareas recientes.
  • Las versiones de PostgreSQL de origen y de destino solicitadas, así como el resultado de SHOW server_version;.
  • La hora aproximada de la interrupción y la zona horaria.
  • Si las aplicaciones pueden conectarse, leer y escribir.
  • Resultados de las consultas de autocomprobación.
  • El CRN de cada réplica de solo lectura relacionada, incluidas las réplicas promocionadas o eliminadas recientemente.

Si la solicitud falla debido a un error interno, ponte en contacto con el servicio de asistencia. En la interfaz de usuario, este error se muestra como La actualización ha fallado con el mensaje No se ha podido crear la tarea de actualización in situ. La interfaz de usuario también muestra este mensaje para otras solicitudes rechazadas cuando no puede mostrar el motivo concreto. Para ver el motivo, envía la solicitud mediante la CLI o la API. Ponte también en contacto con el servicio de asistencia si la tarea tarda mucho más en completarse de lo que te llevó en el ensayo. Tras un fallo, la tarea puede permanecer en curso (estado running en la CLI y la API) mientras el servicio intenta recuperarse.

Elimina únicamente los objetos que se indican en los pasos de preparación y en las consultas de autocomprobación. No sueltes otros objetos para superar un control. Póngase en contacto con el servicio de asistencia.

Actualización a partir de una réplica de solo lectura

Crea una réplica de solo lectura a partir de la implementación de origen y espera a que la réplica se sincronice. A continuación, actualiza la réplica utilizando el punto /remotes/promotion de acceso. Establecer version un destino que la réplica incluya en sus capacidades:

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "promotion": {
        "version": "18",
        "skip_initial_backup": false
    }
}'

Establece el valor en skip_initial_backup true only si deseas omitir la copia de seguridad inicial que crea la promoción. Esta configuración puede acortar la tarea de promoción, pero la recuperación tras la implementación promocionada requiere posteriormente una copia de seguridad programada o bajo demanda que se realice con éxito.

Si falla una promoción con una actualización de versión, el servicio desactiva la implementación promocionada. Póngase en contacto con soporte. Prueba una promoción con una actualización de versión en una réplica de un entorno de pruebas antes de darla por definitiva.

Actualización mediante la restauración de una copia de seguridad

Restaurar una copia de seguridad en una implementación que utilice una versión de destino compatible. Si restaura una copia de seguridad mediante la CLI o la API y no especifica los parámetros de asignación de recursos, la nueva implementación utilizará las asignaciones de recursos que tenía la implementación de origen en el momento en que se creó la copia de seguridad. En la interfaz de usuario, la página de restauración comienza mostrando las asignaciones actuales del despliegue de origen, que se pueden modificar.

Restauración de una copia de seguridad en la IU

En Copias de seguridad y restauración del panel de control de implementación, haz clic en Restaurar copia de seguridad para la copia de seguridad que desees utilizar. En la página que se abre, selecciona una versión de destino compatible en Versión de la base de datos y configura las opciones para la nueva implementación. A continuación, haz clic en Restaurar copia de seguridad.

Restauración de una copia de seguridad a través de la CLI

Crea la implementación con la versión de destino y el ID de copia de seguridad en el argumento JSON -p:

ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
  -p '{
  "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version": "18"
}' \
  --service-endpoints "public"

Restauración de una copia de seguridad mediante la API

Utilice la API del controlador de recursos para restaurar una copia de seguridad en una nueva implementación que ejecute la versión de destino. Especifique el nombre de la implementación, la ubicación, el grupo de recursos, el plan, el ID de la copia de seguridad y la versión de destino:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-postgresql-standard",
    "parameters": {
      "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
      "version": "18"
    }
  }'

Actualización forzada

Tras la fecha de fin de vida útil, todas las implementaciones activas de Databases for PostgreSQL que ejecuten la versión obsoleta se actualizarán automáticamente a la siguiente versión compatible.

Una actualización obligatoria es un IPMVU, por lo que debe completar los preparativos para el IPMVU antes de la fecha de fin de vida útil.

Actualice antes de la fecha de fin de vida útil para evitar los siguientes riesgos:

  • Para este tipo de actualización forzosa no se ofrecen acuerdos de nivel de servicio.
  • Es posible que se produzcan pérdidas de datos.
  • Es posible que su aplicación sufra un periodo de inactividad prolongado.
  • Es posible que tu aplicación deje de funcionar si no es compatible con la nueva versión.
  • No puede controlar el momento en que se producirá esta actualización para su implantación.
  • No hay proceso de reversión para esta actualización forzada.
  • Si Terraform gestiona la implementación y configura version, todos los fallarán terraform plan tras la actualización forzada hasta que actualices version.

Para conocer las fechas de fin de vida útil, consulta la página de política de versiones.

Problemas con los privilegios de los roles durante las actualizaciones de versión

En PostgreSQL 16 y versiones posteriores, un rol con el atributo CREATEROLE, como admin, necesita el ADMIN OPTION sobre otro rol para poder gestionarlo. La gestión de un rol incluye cambiar su contraseña o sus atributos, eliminarlo y conceder la pertenencia al mismo. Una actualización de PostgreSQL 14 o 15 a la versión 16 o posterior no ofrece esta admin opción en los roles que ya existían antes de la actualización. Las tareas que gestionan estas funciones admin, como la rotación de contraseñas, fallan. Para obtener más información, consulta las notas de la versión 16 de PostgreSQL, los atributos de los roles y las concesiones de roles.

Por ejemplo, el cambio de contraseña falla con el siguiente mensaje:

ERROR:  permission denied to alter role
DETAIL:  To change another role's password, the current user must have the CREATEROLE attribute and the ADMIN option on the role.

Antes de actualizar, ejecuta la siguiente consulta como admin. En él se enumeran los roles que admin no se podrán gestionar tras la actualización, salvo los usuarios que se creen en la interfaz de usuario, mediante la CLI o a través de la API. En PostgreSQL 16 y versiones posteriores, tampoco se pueden admin modificar esos usuarios, por lo que hay que gestionarlos a través de la interfaz de usuario, la CLI o la API.

SELECT r.rolname AS role_name,
       pg_catalog.pg_has_role(r.oid, 'admin'::name, 'MEMBER') AS member_of_admin
FROM pg_catalog.pg_roles AS r
WHERE NOT r.rolsuper
  AND NOT r.rolreplication
  AND r.rolname <> 'admin'
  AND r.rolname !~ '^(pg_|ibm-)'
  AND NOT EXISTS (
      SELECT 1
      FROM pg_catalog.pg_auth_members AS m
      JOIN pg_catalog.pg_roles AS b ON b.oid = m.roleid
      WHERE m.member = r.oid
        AND b.rolname IN ('ibm-cloud-base-user', 'ibm-cloud-base-user-ro'))
  AND NOT pg_catalog.pg_has_role(r.oid, 'MEMBER WITH ADMIN OPTION')
ORDER BY 1;

Para seguir gestionando una función de la lista, asígnela a antes admin de actualizar:

GRANT <role_name> TO admin WITH ADMIN OPTION;

Esta concesión falla para un rol cuyo valor member_of_admin es t, ya que dicho rol es miembro de admin. Tras la actualización, admin no puede gestionar ese rol.

Tras actualizar a PostgreSQL 16 o una versión posterior, vuelve a ejecutar la consulta. Para cada rol de la lista cuyo valor member_of_admin sea f, ejecuta la siguiente función auxiliar mientras estás conectado a ibmclouddb o a cualquier base de datos excepto postgres. No incluyas otros roles, ya que si falla una concesión, se cancela toda la llamada. Puedes ejecutar el programa auxiliar con total seguridad más de una vez:

SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');

Ambas concesiones también convierten admin a en miembro del rol, por lo que admin puede hacer uso de los privilegios del rol.

Registro de cambios para las versiones principales de PostgreSQL