Control de cambios de versión de Oracle APEX

Oracle mantiene la instancia de Oracle APEX en su base de datos de IA autónoma mediante la aplicación de nuevas versiones y paquetes de juegos de parches. Cuando haya disponible una nueva versión de APEX en su región, puede elegir cuándo aplicarla durante la ventana de cambio de versión. Oracle aplica los paquetes de juegos de parches automáticamente durante los períodos de mantenimiento programados.

Acerca de las revisiones y parches de Oracle APEX

La base de datos de IA autónoma recibe dos tipos de actualizaciones de Oracle APEX:

Las nuevas versiones actualizan APEX a una nueva versión de funciones, por ejemplo, de la 24.2.17 a la 26.1.0. Incluyen correcciones de errores y nuevas características del producto. Puede que la región de Oracle Cloud Infrastructure (OCI) tarde entre 2 y 5 semanas en recibir la nueva versión una vez que esté disponible para su descarga en oracle.com. Cuando haya una nueva versión disponible en su región, puede aplicarla durante la ventana de actualización de 45 días. Los clientes con instancias de pago pueden ampliar la ventana a 90 días. Si no realiza ninguna acción, Oracle aplica la versión automáticamente al final de la ventana de actualización.
Los paquetes de juegos de parches actualizan APEX dentro de la misma familia de versiones, por ejemplo, de la versión 26.1.0 a la 26.1.1. Los paquetes de juegos de parches incluyen correcciones de bugs y ninguna nueva funcionalidad. Oracle aplica parches automáticamente durante las ventanas de mantenimiento programadas de la base de datos cuando se aplican parches al componente de diccionario.

Las nuevas versiones de APEX y los paquetes de juegos de parches están disponibles en el siguiente orden:

Bases de datos de IA autónomas siempre gratis, bases de datos de IA autónomas para desarrolladores y bases de datos en el nivel de parche Early.
Una semana después, las bases de datos en el nivel de parche Regular.

Consulte Definición del Nivel de Parche para más información sobre los niveles de parche de la base de datos.

Las bases de datos de IA autónomas en los servicios de Oracle Multicloud reciben nuevas versiones de APEX y paquetes de conjuntos de parches al mismo tiempo que las bases de datos en OCI. Consulte Base de datos de IA autónoma en entornos multinube para obtener más información.

Para validar una nueva versión de APEX antes de actualizar la base de datos de producción, clone la base de datos, aplique la nueva versión al clon y pruebe las aplicaciones en el clon. Consulte Clonación de una instancia de base de datos de IA autónoma para obtener más información.

Notificaciones de parches y actualizaciones de Oracle APEX

Oracle utiliza tres canales de notificación para anunciar las versiones de Oracle APEX y los paquetes de juegos de parches:

Banner en el creador de aplicaciones APEX: cuando una nueva versión de APEX esté disponible para tu base de datos de IA autónoma, los desarrolladores verán un banner de anuncios cuando inicien sesión en el creador de aplicaciones APEX.
Notificaciones por correo electrónico: Oracle envía un correo electrónico a los contactos de los clientes de cada base de datos de IA autónoma cuando hay disponible una nueva versión de APEX en esa región. En este correo electrónico se describen las novedades de esta versión de APEX y se explica cómo desplegarla en su base de datos. Para suscribirse, consulte Visualización y gestión de contactos de cliente para anuncios y problemas operativos.
Eventos de OCI Information: Autonomous AI Database emite un evento APEXUpgradeAvailable cuando hay disponible una nueva versión de APEX. Emite el evento APEXUpgradeBegin cuando se inicia el despliegue de una actualización o un parche de APEX y el evento APEXUpgradeEnd cuando finaliza el despliegue. Consulte Eventos de información sobre la base de datos de IA autónoma y Notificación de eventos de base de datos de IA autónoma.

Si la base de datos no utiliza APEX, Autonomous AI Database no envía notificaciones por correo electrónico y no emite eventos de información de OCI relacionados con APEX.

Ver Ventana Actual de Actualización de Oracle APEX

Puede ver la ventana de cambio de versión actual de Oracle APEX en las siguientes ubicaciones:

Servicios de administración: en la sección Actualizaciones disponibles se muestra si hay disponible una nueva versión, la fecha de actualización automática programada y la ventana de actualización actual.
Creador de aplicaciones: cuando hay disponible una nueva versión, la página de inicio de App Builder muestra el estado de actualización. Los desarrolladores pueden ver el estado, pero solo los administradores de la instancia pueden aplicar el cambio de versión.

Para ver la ventana de actualización actual en Servicios de administración:

Abra APEX Administration Services.

Consulte Acceso a los servicios de administración de Oracle APEX para obtener más información.
Revise la sección Available Updates (Actualizaciones disponibles) en la barra lateral derecha.

Definir la ventana de actualización de Oracle APEX

Utilice el cuadro de diálogo Actualizaciones disponibles de los servicios de administración de Oracle APEX para definir la ventana de cambio de versión para versiones futuras.

Puede cambiar la ventana de actualización en Servicios de administración solo cuando no hay ninguna actualización disponible actualmente. Si desea ampliar la ventana de cambio de versión después de que haya disponible una nueva versión, utilice la API PL/SQL. Consulte Acerca de la API de PL/SQL de actualización de Oracle APEX para obtener más información.

Para definir la ventana de actualización de APEX:

Abra APEX Administration Services.

Consulte Acceso a los servicios de administración de Oracle APEX para obtener más información.
Abra el cuadro de diálogo Actualizaciones disponibles haciendo clic en el icono de engranaje junto a Actualizaciones disponibles.
Seleccione la ventana de actualización que desee.

Descripción de la ilustración adb_apex_available_updates.png
Haga clic en Aplicar cambios.

Notas sobre la configuración de la ventana de actualización de Oracle APEX

No puede programar un cambio de versión de APEX para una fecha y hora específicas. Cuando una nueva versión esté disponible, puede dejar que Oracle la aplique automáticamente en la fecha programada o aplicarla manualmente en cualquier momento antes de esa fecha.
Si la base de datos no ha tenido actividad de APEX en los últimos 6 meses, Oracle aplica la siguiente actualización de APEX automáticamente independientemente de la configuración de la ventana de actualización.

Aplicación de actualizaciones de Oracle APEX

Cuando haya una nueva versión de APEX disponible, puede aplicarla en cualquier momento antes de la fecha de cambio de versión programada. Si no lo aplica manualmente, Oracle lo aplica automáticamente en la fecha programada que se muestra en Actualizaciones disponibles.

La actualización se ejecuta en segundo plano y continúa por estas fases:

Crear esquemas de base de datos y objetos de base de datos.
Migre los metadatos de la aplicación.
Migre los datos de tiempo de ejecución y cambie a la nueva versión de APEX.
Migre datos de resumen y log adicionales.

Las fases 1 y 4 no bloquean a los usuarios finales de la aplicación. La fase 2 afecta a los desarrolladores que modifican las aplicaciones. La fase 3 afecta a todo el acceso a APEX y se espera que tarde hasta 3 minutos. Oracle instala soporte de lenguaje adicional para el entorno de desarrollo de APEX después de la fase 4.

Para aplicar una actualización de APEX manualmente:

Abra APEX Administration Services.

Consulte Acceso a los servicios de administración de Oracle APEX para obtener más información.
En Actualizaciones disponibles, haga clic en Actualizar ahora.

Si en la sección Actualizaciones disponibles se muestra El sistema está actualizado, la base de datos de IA autónoma ya está ejecutando la última versión de APEX disponible en su región.

A continuación se muestra la descripción de adb_apex_updates_deferred.png

Descripción de la ilustración adb_apex_updates_deferred.png

Una vez iniciado el cambio de versión, los administradores pueden seguir supervisando el estado en Administration Services o mediante la API PL/SQL, y los desarrolladores pueden ver el estado en App Builder.

Nota

Nota: Para aplicar una actualización de APEX al utilizar la imagen de contenedor libre de base de datos de IA autónoma, migre a una versión más reciente de la imagen de contenedor libre. Consulte Uso de la imagen de contenedor libre de base de datos de IA autónoma para obtener más información.

Acerca de la API de PL/SQL de Actualización de Oracle APEX

Utilice la API PL/SQL de Oracle APEX para ver el estado del cambio de versión, cambiar la ventana de cambio de versión y aplicar un cambio de versión disponible mediante programación.

Los siguientes parámetros de instancia controlan las actualizaciones de APEX en Autonomous AI Database.

Parámetro	Descripción
`UPGRADE_DATE`	Fecha programada para el siguiente cambio de versión de APEX o NULL cuando no se programa ningún cambio de versión. El valor utiliza el formato ISO 8601 en UTC.
`UPGRADE_DEFERRED`	Controla la ventana de actualización de futuras versiones de APEX. Defínalo en `N` para la ventana por defecto o en `Y` para la ventana ampliada. Si la siguiente versión ya está programada, al cambiar este valor se reprograma esa versión. Al volver a definir el valor en `Y`, no se amplía aún más la ventana de cambio de versión.
`UPGRADE_STATUS`	Muestra el estado de la siguiente actualización de APEX. Los valores posibles son `UP-TO-DATE`, `SCHEDULED` y `RUNNING`. Defínalo en `RUN` para aplicar la actualización disponible.
`UPGRADE_VERSION`	Versión de APEX que se instalará en la próxima actualización programada o NULL cuando no se programe ninguna actualización.

Para examinar los valores de parámetros actuales, utilice la API de PL/SQL APEX_INSTANCE_ADMIN.GET_PARAMETER. Para definir valores de parámetros, utilice APEX_INSTANCE_ADMIN.SET_PARAMETER. Consulte Valores de parámetro disponibles en Referencia de API de Oracle APEX para más información.

Para ver el estado actual de la actualización de APEX mediante la API de PL/SQL:

Conéctese a la base de datos como ADMIN o como otro usuario de base de datos con el rol APEX_ADMINISTRATOR_ROLE.

Ejecute la siguiente consulta:

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_STATUS') as upgrade_status,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DEFERRED') as upgrade_deferred,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_VERSION') as upgrade_version,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DATE') as upgrade_date
  from dual;

Si no hay ninguna actualización disponible, el resultado de la consulta será similar al siguiente:

UPGRADE_STATUS UPGRADE_DEFERRED UPGRADE_VERSION UPGRADE_DATE
-------------- ---------------- --------------- ------------
UP-TO-DATE     Y                null            null

Si hay una actualización disponible, el resultado será similar al siguiente:

UPGRADE_STATUS UPGRADE_DEFERRED UPGRADE_VERSION UPGRADE_DATE
-------------- ---------------- --------------- --------------------
SCHEDULED      Y                26.1.0          2026-08-30T19:06:11Z

Para definir la ventana de actualización de APEX mediante la API de PL/SQL:

Conéctese a la base de datos como ADMIN o como otro usuario de base de datos con el rol APEX_ADMINISTRATOR_ROLE.
Defina el valor UPGRADE_DEFERRED en N para la ventana de cambio de versión por defecto o Y para la ventana de cambio de versión ampliada.
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_DEFERRED', 'Y');
  commit;
end;
```

Compruebe la configuración.

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DEFERRED') as upgrade_deferred
  from dual;

Para aplicar la actualización de APEX disponible mediante la API de PL/SQL:

Conéctese a la base de datos como ADMIN o como otro usuario de base de datos con el rol APEX_ADMINISTRATOR_ROLE.
Ejecute el siguiente bloque PL/SQL:
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_STATUS', 'RUN');
  commit;
end;
```
El bloque PL/SQL inicia el cambio de versión y se devuelve inmediatamente.
Verifique que el cambio de versión se haya iniciado.
```
select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_STATUS') as upgrade_status
  from dual;
```
Si el cambio de versión se ha iniciado, el resultado será similar al siguiente:
```
UPGRADE_STATUS
--------------
RUNNING
```

Documentación de Oracle Cloud Infrastructure