View a markdown version of this page

Vorabprüfungen für kleinere Versionen in Amazon RDS for Oracle ausführen - Amazon Relational Database Service
Eine Vorabprüfung durchführenAnzeigen der ErgebnisseInterpretieren der ErgebnisseWas prüft der PrecheckWann soll der Precheck ausgefü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.

Vorabprüfungen für kleinere Versionen in Amazon RDS for Oracle ausführen

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 schon vor dem Wartungsfenster finden und beheben. Verwenden Sie das Amazon RDS-Verfahren, um die Prüfungen durchzuführen rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. Die Vorabprüfung ist schreibgeschützt. Es ändert weder Ihre Daten noch Ihre Konfiguration.

Die Prozedur gibt eine Aufgaben-ID zurück. Die Vorprü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 den Precheck auf Ihrer primären DB-Instance aus. Das Ausführen von Prechecks auf einer Read Replica wird nicht unterstützt.

Vorabprüfung für ein Upgrade einer Nebenversion ausführen

Um zu überprüfen, ob Ihre DB-Instance für ein Upgrade der DB-Nebenversion bereit ist, führen Sie das Verfahren aus rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. 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.

Der Precheck läuft im Hintergrund. Es ist beendet, wenn die letzte Zeile des Logs The task finished successfully. oder The task failed.

Die Ergebnisse der Vorprüfung anzeigen

Um die Protokolldatei zu lesen, führen Sie das Amazon RDS-Verfahren aus rdsadmin.rds_file_util.read_text_file. Fügen Sie die Aufgaben-ID in den Dateinamen ein. 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;

Für weitere Informationen über das Verfahren rdsadmin.rds_file_util.read_text_file, siehe Lesen von Dateien in einem DB-Instance-Verzeichnis.

Interpretation der Ergebnisse der Vorprüfung

Das Protokoll hat einen CHECK: Zeile für jeden Scheck, gefolgt von einer Summary: Zeile und a Result: Linie. 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 Überprüfung konnte nicht abgeschlossen werden. Führen Sie den Precheck erneut durch.

Jede Prüfung wird ausgeführt, auch wenn eine frühere Prüfung fehlschlägt. Ein Durchlauf meldet also jedes Problem, das die Vorprüfung findet. Falls eine Prüfung Berichte meldet FAILED [BLOCKER] oder ERROR, zeigt das Protokoll Result: FAILED. Ansonsten zeigt es sich Result: 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.

Korrigieren Sie jedes Problem, das im Protokoll gemeldet wird, und führen Sie dann den Precheck erneut aus, um zu bestätigen, dass Ihre DB-Instance erfolgreich ist.

Was überprüft der Precheck

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

Check Schlägt fehl wenn
FreeStorageSpace Die DB-Instance hat weniger als 768 MB freien Speicherplatz.
SystemTablespace Die SYSTEM oder SYSAUX Tablespace hat weniger als 300 MB freien Speicherplatz oder ist nicht automatisch erweiterbar. Bei einer CDB überprüft der Precheck jeden Container.
AuditTablespace Der Audit-Tablespace hat weniger als 300 MB freien Speicherplatz oder ist nicht automatisch erweiterbar.
RedoApplyLag Die Verzögerung beim Redo Apply-Read Replica beträgt mehr als 5 Minuten. Wird übersprungen, wenn die DB-Instance keine Read Replicas hat.
MdsysUser Die MDSYS Benutzer ist nicht Oracle-maintained.
ConflictingSynonyms Synonyme verwenden Namen, die die neue Oracle-Version reserviert.
WorkspaceManager Workspace Manager (WMSYS) Objekte sind vorhanden.
SchemaVersionRegistry Eins 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 Bundesstaat.
CtxsysSequences Der CTXSYS Schema hat nicht die 3 Oracle Text-Sequenzen (DR_ID_SEQ, MESG_ID_SEQ, THS_SEQ). Für eine 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 ausgeführt werden

Einige Bedingungen ändern sich im Laufe der Zeit, z. B. freier Speicherplatz und Verzögerung beim Lesen der Replikate. Führen Sie den Precheck kurz vor dem Upgrade durch. Wenn Ihre DB-Instance automatische Nebenversions-Upgrades verwendet, führen Sie den Precheck aus, nachdem Sie die Benachrichtigung über ausstehende Wartungsarbeiten erhalten haben, und vor Ihrem Wartungsfenster.

Wenn Sie eine Änderung vornehmen, die sich auf einen geprüften Zustand auswirkt, führen Sie den Precheck erneut aus. Führen Sie ihn 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, wirken sich nicht auf das Ergebnis aus. Wenn Sie beispielsweise ein Backup erstellen oder die DB-Instance-Klasse ändern, ändert sich das Ergebnis nicht.

Anmerkung

Der Precheck führt die Prüfungen für Ihre aktuelle Engine-Version durch. Es beinhaltet keine Prüfungen, die von der Version abhängen, auf die Sie ein Upgrade durchführen.