Oracle APEX-Upgrades steuern

Oracle verwaltet die Oracle APEX-Instanz in Ihrer autonomen KI-Datenbank, indem neue Releases und Patchset-Bundles eingespielt werden. Wenn ein neues APEX-Release in Ihrer Region verfügbar ist, können Sie wählen, wann es während des Upgradefensters eingespielt werden soll. Oracle wendet Patchset-Bundles automatisch während geplanter Wartungsfenster an.

Oracle APEX-Upgrades und -Patches

Die autonome KI-Datenbank erhält zwei Arten von Oracle APEX-Updates:

Neue Releases aktualisieren APEX auf ein neues Featurerelease, z.B. von 24.2.17 auf 26.1.0. Dazu gehören Bugfixes und neue Produktfeatures. Es kann 2-5 Wochen dauern, bis Ihre Oracle Cloud Infrastructure-(OCI-)Region das neue Release erhält, nachdem es auf oracle.com zum Download verfügbar ist. Wenn ein neues Release in Ihrer Region verfügbar ist, können Sie es während des 45-tägigen Upgradefensters anwenden. Kunden mit kostenpflichtigen Instanzen können das Fenster auf 90 Tage verlängern. Wenn Sie keine Aktion ausführen, wendet Oracle das Release automatisch am Ende des Upgradefensters an.
Patchset-Bundles aktualisieren APEX innerhalb derselben Releasefamilie, z.B. von 26.1.0 auf 26.1.1. Patchset-Bundles enthalten Programmfehlerkorrekturen sowie keine neuen Funktionen. Oracle wendet Patches automatisch während der geplanten Datenbankwartungsfenster an, wenn die Dictionary-Komponente gepatcht wird.

Autonome KI-Datenbanken auf Early-Patch-Ebene erhalten eine Woche vor Datenbanken auf Regular-Patch-Ebene neue APEX-Releases und Patchset-Bundles. Weitere Informationen finden Sie unter Patchebene festlegen.

Um ein neues APEX-Release zu validieren, bevor Sie Ihre Produktionsdatenbank upgraden, klonen Sie die Datenbank, wenden Sie das neue Release auf den Klon an, und testen Sie Ihre Anwendungen auf dem Klon. Weitere Informationen finden Sie unter Autonome KI-Datenbankinstanz klonen.

Oracle APEX-Upgrade- und Patchbenachrichtigungen

Oracle nutzt drei Benachrichtigungskanäle, um Oracle APEX-Releases und Patchset-Bundles anzukündigen:

Banner in APEX App Builder: Wenn ein neues APEX-Release für Ihre autonome KI-Datenbank verfügbar ist, werden Entwickler bei der Anmeldung bei APEX App Builder ein Ankündigungsbanner angezeigt.
E-Mail-Benachrichtigungen: Oracle sendet eine E-Mail an die Kundenkontakte für jede autonome KI-Datenbank, wenn ein neues APEX-Release in dieser Region verfügbar wird. In dieser E-Mail wird beschrieben, was in diesem APEX-Release neu ist. Außerdem wird erläutert, wie Sie es in Ihrer Datenbank bereitstellen. Informationen zum Abonnieren finden Sie unter Kundenkontakte für betriebliche Probleme und Ankündigungen anzeigen oder verwalten.
OCI-Informationsereignisse: Autonomous AI Database gibt das Ereignis APEXUpgradeAvailable aus, wenn ein neues APEX-Release verfügbar ist. Er gibt das Ereignis APEXUpgradeBegin aus, wenn ein APEX-Upgrade oder -Patch mit dem Deployment beginnt, und das Ereignis APEXUpgradeEnd, wenn das Deployment abgeschlossen ist. Siehe Informationsereignisse zur autonomen KI-Datenbank und Benachrichtigen Sie sich über autonome KI-Datenbankereignisse.

Wenn Ihre Datenbank APEX nicht verwendet, gibt Autonomous AI Database keine Informationsereignisse im Zusammenhang mit APEX aus.

Aktuelles Oracle APEX-Upgradefenster anzeigen

Sie können das aktuelle Oracle APEX-Upgradefenster an den folgenden Orten anzeigen:

Administration Services: Im Abschnitt Verfügbare Updates wird angezeigt, ob ein neues Release verfügbar ist, das geplante automatische Upgradedatum und das aktuelle Upgradefenster.
App Builder: Wenn ein neues Release verfügbar ist, wird auf der App Builder-Homepage der Upgradestatus angezeigt. Entwickler können den Status anzeigen, aber nur Instanzadministratoren können das Upgrade anwenden.

So zeigen Sie das aktuelle Upgradefenster in Administration Services an:

Öffnen Sie APEX Administration Services.

Weitere Informationen finden Sie unter Auf Oracle APEX Administration Services zugreifen.
Prüfen Sie den Abschnitt Verfügbare Updates in der rechten Randleiste.

Oracle APEX-Upgradefenster festlegen

Im Dialogfeld Verfügbare Updates in Oracle APEX Administration Services können Sie das Upgradefenster für zukünftige Releases festlegen.

Sie können das Upgradefenster in Administration Services nur ändern, wenn derzeit kein Upgrade verfügbar ist. Wenn Sie das Upgradefenster erweitern möchten, nachdem ein neues Release verfügbar ist, verwenden Sie die PL/SQL-API.

So legen Sie das APEX-Upgradefenster fest:

Öffnen Sie APEX Administration Services.

Weitere Informationen finden Sie unter Auf Oracle APEX Administration Services zugreifen.
Öffnen Sie das Dialogfeld Verfügbare Updates, indem Sie auf das Zahnradsymbol neben Verfügbare Updates klicken.
Wählen Sie das gewünschte Upgradefenster aus.

Beschreibung der Abbildung adb_apex_available_updates.png
Klicken Sie auf Änderungen anwenden.

Hinweise zum Festlegen des Oracle APEX-Upgradefensters

Sie können kein APEX-Upgrade für ein bestimmtes Datum und eine bestimmte Uhrzeit planen. Wenn ein neues Release verfügbar wird, können Sie es entweder von Oracle automatisch am geplanten Datum anwenden lassen oder es zu einem beliebigen Zeitpunkt vor diesem Datum manuell anwenden.
Wenn Ihre Datenbank in den letzten 6 Monaten keine APEX-Aktivität hatte, wendet Oracle das nächste APEX-Upgrade automatisch an, unabhängig von der Einstellung des Upgradefensters.

Oracle APEX-Upgrades anwenden

Wenn ein neues APEX-Release verfügbar ist, können Sie es jederzeit vor dem geplanten Upgradedatum anwenden. Wenn Sie es nicht manuell anwenden, wendet Oracle es automatisch an dem unter Verfügbare Updates angezeigten geplanten Datum an.

Das Upgrade wird im Hintergrund ausgeführt und durchläuft folgende Phasen:

Datenbankschemas und Datenbankobjekte erstellen
Anwendungsmetadaten migrieren.
Migrieren Sie Laufzeitdaten, und wechseln Sie zur neuen APEX-Version.
Zusätzliche Log- und Übersichtsdaten migrieren.

Die Phasen 1 und 4 blockieren keine Endbenutzer von Anwendungen. Phase 2 betrifft Entwickler, die Anwendungen ändern. Phase 3 wirkt sich auf den gesamten APEX-Zugriff aus und wird voraussichtlich bis zu 3 Minuten dauern. Nach der 4. Phase installiert Oracle zusätzliche Sprachunterstützung für die APEX-Entwicklungsumgebung.

So wenden Sie ein APEX-Upgrade manuell an:

Öffnen Sie APEX Administration Services.

Weitere Informationen finden Sie unter Auf Oracle APEX Administration Services zugreifen.
Klicken Sie unter Available Updates auf Upgrade Now.

Wenn im Abschnitt Verfügbare Updates System ist aktuell angezeigt wird, wird in Ihrer autonomen KI-Datenbank bereits das neueste APEX-Release ausgeführt, das in Ihrer Region verfügbar ist.

Beschreibung von adb_apex_updates_deferred.png folgt

Beschreibung der Abbildung adb_apex_updates_deferred.png

Nachdem das Upgrade gestartet wurde, können Administratoren den Status in Administration Services oder mit der PL/SQL-API weiterhin überwachen, und Entwickler können den Status in App Builder anzeigen.

PL/SQL-API für Oracle APEX-Upgrade

Mit der Oracle APEX-PL/SQL-API können Sie den Upgradestatus anzeigen, das Upgradefenster ändern und ein verfügbares Upgrade programmgesteuert anwenden.

Die folgenden Instanzparameter steuern APEX-Upgrades in der autonomen KI-Datenbank:

UPGRADE_DATE: Das geplante Datum für das nächste APEX-Upgrade oder NULL, wenn kein Upgrade geplant ist. Der Wert verwendet das ISO 8601-Format in UTC.
UPGRADE_DEFERRED: Steuert das Upgradefenster für zukünftige APEX-Releases. Setzen Sie es für das Standardfenster auf N oder für das erweiterte Fenster auf Y. Wenn das nächste Release bereits geplant ist, wird dieses Release durch Änderung dieses Werts neu terminiert. Wenn Sie den Wert erneut auf Y setzen, wird das Upgradefenster nicht weiter erweitert.
UPGRADE_STATUS: Zeigt den Status des nächsten APEX-Upgrades an. Mögliche Werte sind UP-TO-DATE, SCHEDULED und RUNNING. Setzen Sie es auf RUN, um das verfügbare Upgrade anzuwenden.
UPGRADE_VERSION: Die APEX-Version, die beim nächsten geplanten Upgrade installiert wird, oder NULL, wenn kein Upgrade geplant ist.

Um die aktuellen Parameterwerte zu prüfen, verwenden Sie die PL/SQL-API APEX_INSTANCE_ADMIN.GET_PARAMETER. Um Parameterwerte festzulegen, verwenden Sie APEX_INSTANCE_ADMIN.SET_PARAMETER. Weitere Informationen finden Sie unter Verfügbare Parameterwerte in der Oracle APEX-API-Referenz.

So zeigen Sie den aktuellen APEX-Upgradestatus mit der PL/SQL-API an:

Melden Sie sich als ADMIN oder als anderer Datenbankbenutzer mit der Rolle APEX_ADMINISTRATOR_ROLE bei der Datenbank an.

Führen Sie folgende Abfrage aus:

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;

Wenn kein Upgrade verfügbar ist, ähnelt das Abfrageergebnis dem Folgenden:

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

Wenn ein Upgrade verfügbar ist, sieht das Ergebnis wie folgt aus:

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

So legen Sie das APEX-Upgradefenster mit der PL/SQL-API fest:

Melden Sie sich als ADMIN oder als anderer Datenbankbenutzer mit der Rolle APEX_ADMINISTRATOR_ROLE bei der Datenbank an.
Setzen Sie den Wert UPGRADE_DEFERRED für das Standardupgradefenster auf N oder für das erweiterte Upgradefenster auf Y.
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_DEFERRED', 'Y');
  commit;
end;
```

Prüfen Sie die Einstellung.

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

So wenden Sie das verfügbare APEX-Upgrade mit der PL/SQL-API an:

Melden Sie sich als ADMIN oder als anderer Datenbankbenutzer mit der Rolle APEX_ADMINISTRATOR_ROLE bei der Datenbank an.
Führen Sie den folgenden PL/SQL-Block aus:
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_STATUS', 'RUN');
  commit;
end;
```
Der PL/SQL-Block initiiert das Upgrade und kehrt sofort zurück.

Prüfen Sie, ob das Upgrade gestartet wurde.

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

Wenn das Upgrade gestartet wurde, sieht das Ergebnis wie folgt aus:

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

Oracle Cloud Infrastructure-Dokumentation