Contrôle des mises à niveau Oracle APEX

Oracle gère l'instance Oracle APEX dans votre base de données Autonomous AI en appliquant les nouvelles versions et les groupes d'ensembles de patches. Lorsqu'une nouvelle version d'APEX est disponible dans votre région, vous pouvez choisir quand l'appliquer pendant la fenêtre de mise à niveau. Oracle applique automatiquement les groupes de jeux de patches pendant les fenêtres de maintenance programmées.

A propos des mises à niveau et des patches Oracle APEX

Autonomous AI Database reçoit deux types de mises à jour Oracle APEX :

Nouvelles versions mettent à jour APEX vers une nouvelle version de fonctionnalité, par exemple, de la version 24.2.17 à la version 26.1.0. Ils incluent des corrections de bogues et de nouvelles fonctionnalités du produit. La réception de la nouvelle version par votre région Oracle Cloud Infrastructure (OCI) après sa mise à disposition pour téléchargement sur oracle.com peut prendre entre 2 et 5 semaines. Lorsqu'une nouvelle version est disponible dans votre région, vous pouvez l'appliquer pendant la fenêtre de mise à niveau de 45 jours. Les clients disposant d'instances payantes peuvent prolonger la fenêtre de 90 jours. Si vous n'effectuez aucune action, Oracle applique automatiquement la version à la fin de la fenêtre de mise à niveau.
Les bundles de jeux de patches mettent à jour APEX dans la même famille de versions, par exemple de la version 26.1.0 à la version 26.1.1. Les groupes de jeux de patches incluent des correctifs de bogues et aucune nouvelle fonctionnalité. Oracle applique automatiquement les patches lors des fenêtres de maintenance programmées de la base de données lorsque le patch est appliqué au composant Dictionnaire.

Les nouvelles versions APEX et les groupes de jeux de patches sont disponibles dans l'ordre suivant :

Bases de données d'IA autonomes Toujours gratuit, bases de données d'IA autonomes pour les développeurs, bases de données au niveau des premiers patches.
Une semaine plus tard, les bases de données au niveau des patches standard.

Pour plus d'informations sur les niveaux de patch de base de données, reportez-vous à la section Définition du niveau de patch.

Les bases de données d'IA autonomes dans les services Oracle Multicloud reçoivent de nouvelles versions APEX et des ensembles de patches en même temps que les bases de données dans OCI. Pour plus d'informations, reportez-vous à Base de données Autonomous AI dans les environnements multicloud.

Pour valider une nouvelle version d'APEX avant de mettre à niveau votre base de données de production, clonez votre base de données, appliquez la nouvelle version au clone et testez vos applications sur le clone. Pour plus d'informations, reportez-vous à Clonage d'une instance de base de données Autonomous AI.

Notifications de mise à niveau et de patch Oracle APEX

Oracle utilise trois canaux de notification pour annoncer les versions d'Oracle APEX et les groupes d'ensembles de patches :

Bannière dans APEX App Builder : lorsqu'une nouvelle version d'APEX sera disponible pour votre base de données Autonomous AI, les développeurs verront une bannière d'annonce lorsqu'ils se connecteront à APEX App Builder.
Notifications par courriel : Oracle envoie un courriel aux contacts client pour chaque base de données d'IA autonome lorsqu'une nouvelle version d'APEX devient disponible dans cette région. Ce courriel décrit les nouveautés de cette version APEX et explique comment le déployer dans votre base de données. Pour vous abonner, reportez-vous à Affichage et gestion des contacts client pour des problèmes opérationnels et des annonces.
Evénements d'informations OCI : Autonomous AI Database émet un événement APEXUpgradeAvailable lorsqu'une nouvelle version d'APEX est disponible. Il émet l'événement APEXUpgradeBegin lorsqu'une mise à niveau ou un patch APEX commence le déploiement, et l'événement APEXUpgradeEnd lorsqu'il termine le déploiement. Reportez-vous à Evénements d'information sur la base de données d'IA autonome et à Obtention de la notification des événements de base de données d'IA autonome.

Si votre base de données n'utilise pas APEX, Autonomous AI Database n'envoie pas de notifications par courriel et n'émet pas d'événements d'informations OCI liés à APEX.

Afficher la fenêtre de mise à niveau actuelle d'Oracle APEX

Vous pouvez afficher la fenêtre de mise à niveau d'Oracle APEX en cours aux emplacements suivants :

Services d'administration : la section Mises à jour disponibles indique si une nouvelle version est disponible, la date de mise à niveau automatique programmée et la fenêtre de mise à niveau en cours.
App Builder : lorsqu'une nouvelle version est disponible, la page d'accueil d'App Builder affiche le statut de mise à niveau. Les développeurs peuvent voir le statut, mais seuls les administrateurs d'instance peuvent appliquer la mise à niveau.

Pour afficher la fenêtre de mise à niveau actuelle dans Administration Services :

Ouvrez les services d'administration APEX.

Pour plus d'informations, reportez-vous à Accès aux services d'administration Oracle APEX.
Consultez la section Mises à jour disponibles dans la barre latérale droite.

Définir la fenêtre de mise à niveau d'Oracle APEX

Utilisez la boîte de dialogue Mises à jour disponibles dans les services d'administration Oracle APEX pour définir la fenêtre de mise à niveau pour les versions futures.

Vous ne pouvez modifier la fenêtre de mise à niveau dans Administration Services que lorsqu'aucune mise à niveau n'est actuellement disponible. Si vous souhaitez étendre la fenêtre de mise à niveau une fois qu'une nouvelle version est disponible, utilisez l'API PL/SQL. Pour plus d'informations, reportez-vous à A propos de l'API PL/SQL de mise à niveau d'Oracle APEX.

Pour définir la fenêtre de mise à niveau d'APEX, procédez comme suit :

Ouvrez les services d'administration APEX.

Pour plus d'informations, reportez-vous à Accès aux services d'administration Oracle APEX.
Ouvrez la boîte de dialogue Mises à jour disponibles en cliquant sur l'icône d'engrenage en regard de Mises à jour disponibles.
Sélectionnez la fenêtre de mise à niveau souhaitée.

Description de l'image adb_apex_available_updates.png
Cliquez sur Appliquer les modifications.

Remarques sur la configuration de la fenêtre de mise à niveau d'Oracle APEX

Vous ne pouvez pas planifier de mise à niveau APEX pour une date et une heure spécifiques. Lorsqu'une nouvelle version devient disponible, vous pouvez laisser Oracle l'appliquer automatiquement à la date prévue ou l'appliquer manuellement à tout moment avant cette date.
Si votre base de données n'a pas eu d'activité APEX au cours des 6 derniers mois, Oracle applique automatiquement la prochaine mise à niveau APEX, quel que soit le paramètre de la fenêtre de mise à niveau.

Appliquer les mises à niveau d'Oracle APEX

Lorsqu'une nouvelle version d'APEX est disponible, vous pouvez l'appliquer à tout moment avant la date de mise à niveau programmée. Si vous ne l'appliquez pas manuellement, Oracle l'applique automatiquement à la date programmée indiquée dans Mises à jour disponibles.

La mise à niveau s'exécute en arrière-plan et passe par les phases suivantes :

Créez des schémas et des objets de base de données.
Migrer les métadonnées d'application.
Migrez les données d'exécution et passez à la nouvelle version d'APEX.
Migrer des données de journal et de synthèse supplémentaires.

Les phases 1 et 4 ne bloquent pas les utilisateurs finals des applications. La phase 2 concerne les développeurs qui modifient les applications. La phase 3 affecte tous les accès à APEX et devrait prendre jusqu'à 3 minutes. Oracle installe une prise en charge linguistique supplémentaire pour l'environnement de développement APEX après la phase 4.

Pour appliquer manuellement une mise à niveau APEX, procédez comme suit :

Ouvrez les services d'administration APEX.

Pour plus d'informations, reportez-vous à Accès aux services d'administration Oracle APEX.
Dans Mises à jour disponibles, cliquez sur Mettre à niveau maintenant.

Si la section Mises à jour disponibles affiche Le système est à jour, votre base de données Autonomous AI exécute déjà la dernière version d'APEX disponible dans votre région.

Description d'adb_apex_updates_deferred.png ci-après

Description de l'image adb_apex_updates_deferred.png

Une fois la mise à niveau démarrée, les administrateurs peuvent continuer à surveiller le statut dans Administration Services ou à l'aide de l'API PL/SQL, et les développeurs peuvent visualiser le statut dans App Builder.

Remarque

Remarque : pour appliquer une mise à niveau APEX lors de l'utilisation de l'image de conteneur gratuite de base de données Autonomous AI, migrez vers une version plus récente de l'image de conteneur gratuit. Pour plus d'informations, reportez-vous à Utilisation de l'image de conteneur gratuite Autonomous AI Database.

A propos de l'API PL/SQL de mise à niveau d'Oracle APEX

Utilisez l'API PL/SQL Oracle APEX pour afficher le statut de la mise à niveau, modifier la fenêtre de mise à niveau et appliquer une mise à niveau disponible par programmation.

Les paramètres d'instance suivants contrôlent les mises à niveau APEX dans la base de données Autonomous AI.

Paramètre	Description
`UPGRADE_DATE`	Date programmée pour la prochaine mise à niveau APEX ou NULL lorsqu'aucune mise à niveau n'est programmée. La valeur utilise le format ISO 8601 au format UTC.
`UPGRADE_DEFERRED`	Contrôle la fenêtre de mise à niveau pour les prochaines versions d'APEX. Définissez-le sur `N` pour la fenêtre par défaut ou sur `Y` pour la fenêtre étendue. Si la prochaine version est déjà planifiée, la modification de cette valeur reprogramme cette version. Si vous définissez à nouveau la valeur sur `Y`, la fenêtre de mise à niveau ne sera plus étendue.
`UPGRADE_STATUS`	Affiche le statut de la prochaine mise à niveau APEX. Les valeurs possibles sont `UP-TO-DATE`, `SCHEDULED` et `RUNNING`. Définissez-le sur `RUN` pour appliquer la mise à niveau disponible.
`UPGRADE_VERSION`	Version APEX que la prochaine mise à niveau programmée installera ou NULL lorsqu'aucune mise à niveau n'est programmée.

Pour examiner les valeurs de paramètre en cours, utilisez l'API PL/SQL APEX_INSTANCE_ADMIN.GET_PARAMETER. Pour définir des valeurs de paramètre, utilisez APEX_INSTANCE_ADMIN.SET_PARAMETER. Pour plus d'informations, reportez-vous à la section Valeurs de paramètre disponible dans Référence d'API Oracle APEX.

Pour afficher le statut de mise à niveau APEX en cours à l'aide de l'API PL/SQL, procédez comme suit :

Connectez-vous à la base de données en tant qu'utilisateur ADMIN ou en tant qu'autre utilisateur de base de données doté du rôle APEX_ADMINISTRATOR_ROLE.

Exécutez la requête suivante :

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 aucune mise à niveau n'est disponible, le résultat de la requête sera similaire à ce qui suit :

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

Si une mise à niveau est disponible, le résultat sera similaire à ce qui suit :

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

Pour définir la fenêtre de mise à niveau APEX à l'aide de l'API PL/SQL, procédez comme suit :

Connectez-vous à la base de données en tant qu'utilisateur ADMIN ou en tant qu'autre utilisateur de base de données doté du rôle APEX_ADMINISTRATOR_ROLE.
Définissez la valeur UPGRADE_DEFERRED sur N pour la fenêtre de mise à niveau par défaut ou sur Y pour la fenêtre de mise à niveau étendue.
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_DEFERRED', 'Y');
  commit;
end;
```

Vérifiez le paramètre.

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

Pour appliquer la mise à niveau APEX disponible à l'aide de l'API PL/SQL, procédez comme suit :

Connectez-vous à la base de données en tant qu'utilisateur ADMIN ou en tant qu'autre utilisateur de base de données doté du rôle APEX_ADMINISTRATOR_ROLE.
Exécutez le bloc PL/SQL suivant :
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_STATUS', 'RUN');
  commit;
end;
```
Le bloc PL/SQL lance la mise à niveau et renvoie immédiatement.

Vérifiez que la mise à niveau a démarré.

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_STATUS') as upgrade_status
  from dual;

Si la mise à niveau a démarré, le résultat sera similaire à ce qui suit :

UPGRADE_STATUS
--------------
RUNNING

Documentation Oracle Cloud Infrastructure