View a markdown version of this page

Durchführung von Vorabprüfungen für kleinere Versions-Upgrades in Amazon RDS for Oracle - Amazon Relational Database Service
Eine Vorabprüfung wird durchgeführtAnzeigen der ErgebnisseInterpretieren der ErgebnisseWas wird bei der Vorabprüfung geprüftWann soll der Precheck durchgeführt werden

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Durchführung von Vorabprüfungen für kleinere Versions-Upgrades in Amazon RDS for Oracle

Bevor Amazon RDS for Oracle ein Upgrade der DB-Nebenversion durchführt, überprüft es, ob sich Ihre DB-Instance in einem Zustand befindet, in dem das Upgrade abgeschlossen werden kann. Wenn bei einer Überprüfung ein Problem festgestellt wird, kann das Upgrade erst fortgesetzt werden, wenn Sie es behoben haben.

Sie können diese Prüfungen jederzeit selbst durchführen, ohne ein Upgrade zu starten. Auf diese Weise können Sie Probleme bereits vor Ablauf des Wartungsfensters finden und beheben. Verwenden Sie das Amazon RDS-Verfahren, um die Prüfungen durchzuführenrdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. Die Vorabprüfung ist schreibgeschützt. Ihre Daten oder Ihre Konfiguration werden dadurch nicht geändert.

Die Prozedur gibt eine Aufgaben-ID zurück. Die Vorabprüfung schreibt ihre Ergebnisse in eine Protokolldatei mit dem Namen dbtask-task_id.log im BDUMP-Verzeichnis. Informationen zum Herunterladen der Protokolldatei finden Sie unter. Herunterladen einer Datenbank-Protokolldatei

Anmerkung

Führen Sie die Vorabprüfung auf Ihrer primären DB-Instance aus. Das Ausführen von Vorprüfungen für eine Read Replica wird nicht unterstützt.

Durchführung einer Vorabprüfung für ein Upgrade einer kleineren Version

Um zu überprüfen, ob Ihre DB-Instance für ein Upgrade der DB-Nebenversion bereit ist, führen Sie das Verfahren rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade aus. Die -Prozedur verwendet keine Parameter. Die folgende Abfrage startet die Vorabprüfung und gibt die Aufgaben-ID zurück.

SQL> SELECT rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade() AS task_id FROM DUAL;

TASK_ID
------------------
1784924903020-9

Sie können die Task-ID auch in einer SQL-Client-Variablen speichern und die Variable in anderen Anweisungen verwenden.

SQL> VAR task_id VARCHAR2(80);
SQL> EXEC :task_id := rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade();

PL/SQL procedure successfully completed.

Die Vorabprüfung läuft im Hintergrund. Sie ist beendet, wenn die letzte Zeile des Logs oder The task finished successfully. The task failed.

Ergebnisse der Vorabprüfung anzeigen

Um die Protokolldatei zu lesen, führen Sie das Amazon RDS-Verfahren ausrdsadmin.rds_file_util.read_text_file. Nehmen Sie die Aufgaben-ID in den Dateinamen auf. Das folgende Beispiel zeigt eine Vorabprüfung, bei der bei keiner Prüfung ein Problem festgestellt wurde.

SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log'));

TEXT
-------------------------------------------------------------------------------------------------------------------------
2026-08-28 18:30:20.461 UTC [INFO ] Starting minor version upgrade precheck...
2026-08-28 18:30:20.461 UTC [INFO ] NOTE: This precheck validates against the current engine version's known checks. Target-version-specific checks (e.g., autoupgrade) are not included.
2026-08-28 18:30:20.470 UTC [INFO ] CHECK: FreeStorageSpace - PASSED
2026-08-28 18:30:20.515 UTC [INFO ] CHECK: SystemTablespace - PASSED
2026-08-28 18:30:20.523 UTC [INFO ] CHECK: AuditTablespace - PASSED
2026-08-28 18:30:20.541 UTC [INFO ] CHECK: RedoApplyLag - SKIPPED: the DB instance has no read replicas
2026-08-28 18:30:20.612 UTC [INFO ] CHECK: MdsysUser - PASSED
2026-08-28 18:30:20.688 UTC [INFO ] CHECK: ConflictingSynonyms - PASSED
2026-08-28 18:30:20.731 UTC [INFO ] CHECK: WorkspaceManager - PASSED
2026-08-28 18:30:20.790 UTC [INFO ] CHECK: SchemaVersionRegistry - PASSED
2026-08-28 18:30:20.846 UTC [INFO ] CHECK: XmlDbSchema - PASSED
2026-08-28 18:30:20.903 UTC [INFO ] CHECK: ApexStatus - PASSED
2026-08-28 18:30:20.955 UTC [INFO ] CHECK: CtxsysSequences - PASSED
2026-08-28 18:30:21.304 UTC [INFO ] CHECK: InvalidSystemObjects - PASSED
2026-08-28 18:30:21.549 UTC [INFO ] CHECK: InvalidTriggers - PASSED
2026-08-28 18:30:21.601 UTC [INFO ] CHECK: PendingDistributedTransactions - PASSED
2026-08-28 18:30:21.602 UTC [INFO ] Summary: 13 passed, 1 skipped, 0 warnings, 0 errors, 0 blockers
2026-08-28 18:30:21.602 UTC [INFO ] Result: PASSED
2026-08-28 18:30:21.602 UTC [INFO ] The task finished successfully.

Führen Sie die folgende Abfrage aus, um die Dateien im BDUMP-Verzeichnis aufzulisten.

SELECT * FROM table(rdsadmin.rds_file_util.listdir('BDUMP')) order by mtime;

Weitere Hinweise zum Verfahren rdsadmin.rds_file_util.read_text_file finden Sie unter. Lesen von Dateien in einem DB-Instance-Verzeichnis

Interpretation der Ergebnisse der Vorabprüfung

Das Protokoll besteht aus einer CHECK: Zeile für jede Prüfung, gefolgt von einer Summary: Zeile und einer Result: Zeile. Welche Prüfungen ausgeführt werden, hängt von Ihrer Engine-Version, Ihrer Datenbankarchitektur und Ihrer DB-Instance-Konfiguration ab. Bei jeder Prüfung wird eines der folgenden Ergebnisse gemeldet.

PASSED

Bei der Überprüfung wurde kein Problem festgestellt.

FAILED [BLOCKER]

Bei der Überprüfung wurde ein Problem festgestellt, das Sie vor dem Upgrade der DB-Nebenversion beheben müssen. Die Zeile beschreibt das Problem und was zu tun ist.

WARN

Bei der Überprüfung wurde etwas gefunden, das Sie überprüfen sollten. Eine Warnung blockiert das Upgrade nicht.

SKIPPED

Die Prüfung gilt nicht für Ihre DB-Instance. Die Zeile gibt den Grund an.

ERROR

Die Prüfung konnte nicht abgeschlossen werden. Führen Sie die Vorabprüfung erneut aus.

Jede Prüfung wird ausgeführt, auch wenn eine frühere Prüfung fehlschlägt. Daher wird bei einem Durchlauf jedes Problem gemeldet, das bei der Vorprüfung gefunden wird. Wenn bei einer Prüfung FAILED [BLOCKER] oder gemeldet wirdERROR, wird dies im Protokoll angezeigtResult: FAILED. Andernfalls wird es angezeigtResult: PASSED.

Das folgende Beispiel zeigt eine Vorabprüfung, bei der ein Problem festgestellt wurde.

SQL> SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||:task_id||'.log'));

TEXT
-------------------------------------------------------------------------------------------------------------------------
2026-08-28 18:57:39.105 UTC [INFO ] Starting minor version upgrade precheck...
2026-08-28 18:57:39.105 UTC [INFO ] NOTE: This precheck validates against the current engine version's known checks. Target-version-specific checks (e.g., autoupgrade) are not included.
2026-08-28 18:57:39.112 UTC [INFO ] CHECK: FreeStorageSpace - PASSED
2026-08-28 18:57:39.125 UTC [INFO ] CHECK: SystemTablespace - PASSED
2026-08-28 18:57:39.133 UTC [INFO ] CHECK: AuditTablespace - PASSED
2026-08-28 18:57:39.150 UTC [INFO ] CHECK: RedoApplyLag - SKIPPED: the DB instance has no read replicas
2026-08-28 18:57:39.221 UTC [INFO ] CHECK: MdsysUser - PASSED
2026-08-28 18:57:39.297 UTC [INFO ] CHECK: ConflictingSynonyms - PASSED
2026-08-28 18:57:39.340 UTC [INFO ] CHECK: WorkspaceManager - PASSED
2026-08-28 18:57:39.399 UTC [INFO ] CHECK: SchemaVersionRegistry - PASSED
2026-08-28 18:57:39.455 UTC [INFO ] CHECK: XmlDbSchema - PASSED
2026-08-28 18:57:39.512 UTC [INFO ] CHECK: ApexStatus - PASSED
2026-08-28 18:57:39.564 UTC [INFO ] CHECK: CtxsysSequences - PASSED
2026-08-28 18:57:39.913 UTC [INFO ] CHECK: InvalidSystemObjects - PASSED
2026-08-28 18:57:40.097 UTC [ERROR] CHECK: InvalidTriggers - FAILED [BLOCKER]: The DB instance has triggers that aren't valid. Fix or disable them.
2026-08-28 18:57:40.151 UTC [INFO ] CHECK: PendingDistributedTransactions - PASSED
2026-08-28 18:57:40.152 UTC [INFO ] Summary: 12 passed, 1 skipped, 0 warnings, 0 errors, 1 blocker
2026-08-28 18:57:40.152 UTC [INFO ] RDS can't upgrade the DB instance. Resolve the blockers listed above, and then try again.
2026-08-28 18:57:40.152 UTC [INFO ] Result: FAILED
2026-08-28 18:57:40.152 UTC [INFO ] The task failed.

Beheben Sie jedes Problem, das im Protokoll gemeldet wird, und führen Sie dann die Vorabprüfung erneut aus, um sicherzustellen, dass Ihre DB-Instance erfolgreich ist.

Was bei der Vorabprüfung geprüft wird

In der folgenden Tabelle sind die einzelnen Prüfungen sowie die Bedingungen aufgeführt, die dazu führen, dass sie fehlschlagen. Schlägt eine Prüfung fehl, beschreibt die entsprechende Zeile im Protokoll das Problem und wie es behoben werden kann.

Check Schlägt fehl wenn
FreeStorageSpace Die DB-Instance verfügt über weniger als 768 MB freien Speicherplatz.
SystemTablespace Der SYSAUX Tablespace SYSTEM oder hat weniger als 300 MB freien Speicherplatz oder ist nicht automatisch erweiterbar. Bei einer CDB überprüft die Vorabprüfung jeden Container.
AuditTablespace Der Audit-Tablespace hat weniger als 300 MB freien Speicherplatz oder ist nicht automatisch erweiterbar.
RedoApplyLag Die Redo Apply-Verzögerung einer Read Replica beträgt mehr als 5 Minuten. Wird übersprungen, wenn die DB-Instance keine Read Replicas hat.
MdsysUser Der MDSYS Benutzer ist es nicht. Oracle-maintained
ConflictingSynonyms Synonyme verwenden Namen, die in der neuen Oracle-Version reserviert sind.
WorkspaceManager Workspace Manager (WMSYS) -Objekte sind vorhanden.
SchemaVersionRegistry Eine oder mehrere SCHEMA_VERSION_REGISTRY Ansichten sind nicht gültig.
XmlDbSchema Ein oder mehrere XML-DB-Schemaobjekte sind nicht gültig.
ApexStatus Die APEX-Komponente befindet sich nicht in einem VALID Status.
CtxsysSequences Das CTXSYS Schema enthält nicht die 3 Oracle-Textsequenzen (DR_ID_SEQ,MESG_ID_SEQ,THS_SEQ). Bei einer CDB übersprungen.
InvalidSystemObjects Oracle-maintained Objekte sind nicht gültig.
InvalidTriggers Trigger sind nicht gültig.
PendingDistributedTransactions Verteilte Transaktionen sind ungelöst.

Wann soll der Precheck durchgeführt werden

Einige Bedingungen ändern sich im Laufe der Zeit, z. B. freier Speicherplatz und verzögerte Lesereplikate. Führen Sie den Precheck kurz vor dem Upgrade durch. Wenn Ihre DB-Instance automatische Upgrades für kleinere Versionen verwendet, führen Sie die Vorabprüfung aus, nachdem Sie die Benachrichtigung über ausstehende Wartungsarbeiten erhalten haben und bevor das Wartungsfenster abgelaufen ist.

Wenn Sie eine Änderung vornehmen, die sich auf einen geprüften Zustand auswirkt, führen Sie die Vorabprüfung erneut aus. Führen Sie es beispielsweise erneut aus, nachdem Sie Speicher hinzugefügt, einen Tablespace geändert, Objekte gelöscht oder neu kompiliert oder verteilte Transaktionen aufgelöst haben. Änderungen, die sich nicht auf diese Bedingungen auswirken, haben keine Auswirkung auf das Ergebnis. Wenn Sie beispielsweise ein Backup erstellen oder die DB-Instance-Klasse ändern, ändert sich das Ergebnis nicht.

Anmerkung

Die Vorabprüfung führt die Prüfungen für Ihre aktuelle Engine-Version durch. Prüfungen, die von der Version abhängen, auf die Sie das Upgrade durchführen, sind nicht enthalten.