Menjalankan prechecks upgrade versi minor di Amazon RDS for Oracle

Sebelum Amazon RDS for Oracle melakukan upgrade versi minor DB, Amazon akan memeriksa apakah instans DB Anda berada dalam keadaan yang memungkinkan pemutakhiran selesai. Jika pemeriksaan menemukan masalah, pemutakhiran tidak dapat dilanjutkan sampai Anda memperbaikinya.

Anda dapat menjalankan pemeriksaan ini sendiri kapan saja tanpa memulai peningkatan. Dengan cara ini, Anda dapat menemukan dan memperbaiki masalah sebelum jendela pemeliharaan Anda. Untuk menjalankan pemeriksaan, gunakan prosedur rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade Amazon RDS. Precheck adalah read-only. Itu tidak mengubah data atau konfigurasi Anda.

Prosedur mengembalikan ID tugas. Precheck menulis hasilnya ke file log bernama dbtask-task_id.log dalam direktori BDUMP. Untuk mengunduh file log, lihatMengunduh file log basis data.

catatan

Jalankan precheck pada instans DB utama Anda. Menjalankan prechecks pada replika baca tidak didukung.

Menjalankan precheck upgrade versi minor

Untuk memeriksa apakah instans DB Anda siap untuk upgrade versi minor DB, jalankan prosedurnyardsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. Prosedur tidak menggunakan parameter. Query berikut memulai precheck dan mengembalikan ID tugas.

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

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

Anda juga dapat menyimpan ID tugas dalam variabel klien SQL dan menggunakan variabel dalam pernyataan lain.

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

PL/SQL procedure successfully completed.

Precheck berjalan di latar belakang. Ini selesai ketika baris terakhir dari log adalah The task finished successfully. atau The task failed.

Melihat hasil precheck

Untuk membaca file log, jalankan prosedur rdsadmin.rds_file_util.read_text_file Amazon RDS. Sertakan ID tugas dalam nama file. Contoh berikut menunjukkan precheck di mana tidak ada cek menemukan masalah.

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.

Untuk daftar file dalam direktori BDUMP, jalankan query berikut.

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

Untuk informasi lebih lanjut tentang prosedur inirdsadmin.rds_file_util.read_text_file, lihatMembaca file di direktori instans DB.

Menafsirkan hasil precheck

Log memiliki satu CHECK: baris untuk setiap cek, diikuti oleh Summary: garis dan Result: garis. Pemeriksaan mana yang dijalankan tergantung pada versi mesin Anda, arsitektur database Anda, dan konfigurasi instans DB Anda. Setiap pemeriksaan melaporkan salah satu hasil berikut.

PASSED

Cek tidak menemukan masalah.

FAILED [BLOCKER]

Pemeriksaan menemukan masalah yang harus Anda perbaiki sebelum upgrade versi minor DB. Garis menggambarkan masalah dan apa yang harus dilakukan.

WARN

Cek menemukan sesuatu yang harus Anda tinjau. Peringatan tidak memblokir peningkatan.

SKIPPED

Pemeriksaan tidak berlaku untuk instans DB Anda. Garis memberikan alasannya.

ERROR

Cek tidak bisa selesai. Jalankan precheck lagi.

Setiap pemeriksaan berjalan, bahkan ketika pemeriksaan sebelumnya gagal, jadi satu run melaporkan setiap masalah yang ditemukan precheck. Jika ada laporan pemeriksaan FAILED [BLOCKER] atauERROR, log akan ditampilkanResult: FAILED. Kalau tidak, itu menunjukkanResult: PASSED.

Contoh berikut menunjukkan precheck yang menemukan satu masalah.

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.

Perbaiki setiap masalah yang dilaporkan log, lalu jalankan precheck lagi untuk mengonfirmasi bahwa instans DB Anda lolos.

Apa yang diperiksa precheck

Tabel berikut mencantumkan setiap pemeriksaan dan kondisi yang membuatnya gagal. Ketika cek gagal, barisnya di log menjelaskan masalah dan cara memperbaikinya.

Periksa	Gagal ketika
FreeStorageSpace	Instans DB memiliki penyimpanan gratis kurang dari 768 MB.
SystemTablespace	SYSAUXRuang meja SYSTEM atau memiliki ruang kosong kurang dari 300 MB, atau tidak dapat diperluas secara otomatis. Untuk CDB, precheck memeriksa setiap kontainer.
AuditTablespace	Ruang tabel audit memiliki ruang kosong kurang dari 300 MB, atau tidak dapat diperluas secara otomatis.
RedoApplyLag	Redo apply lag replika baca lebih dari 5 menit. Dilewati jika instans DB tidak memiliki replika baca.
MdsysUser	MDSYSPengguna tidak Oracle-maintained.
ConflictingSynonyms	Sinonim menggunakan nama yang dicadangkan versi Oracle baru.
WorkspaceManager	Objek Workspace Manager (WMSYS) ada.
SchemaVersionRegistry	Satu atau lebih SCHEMA_VERSION_REGISTRY tampilan tidak valid.
XmlDbSchema	Satu atau lebih objek skema XMLDB tidak valid.
ApexStatus	Komponen APEX tidak dalam VALID keadaan.
CtxsysSequences	CTXSYSSkema tidak memiliki 3 urutan Teks Oracle (DR_ID_SEQ,,MESG_ID_SEQ). THS_SEQ Dilewati untuk CDB.
InvalidSystemObjects	Oracle-maintained objek tidak valid.
InvalidTriggers	Pemicu tidak valid.
PendingDistributedTransactions	Transaksi terdistribusi tidak terselesaikan.

Kapan menjalankan precheck

Beberapa kondisi berubah seiring waktu, seperti penyimpanan gratis dan jeda replika baca. Jalankan precheck sesaat sebelum Anda meningkatkan. Jika instans DB Anda menggunakan upgrade versi minor otomatis, jalankan precheck setelah Anda menerima pemberitahuan pemeliharaan yang tertunda dan sebelum jendela pemeliharaan Anda.

Jika Anda membuat perubahan yang memengaruhi kondisi yang dicentang, jalankan precheck lagi. Misalnya, jalankan lagi setelah Anda menambahkan penyimpanan, mengubah tablespace, menjatuhkan atau mengkompilasi ulang objek, atau menyelesaikan transaksi terdistribusi. Perubahan yang tidak mempengaruhi kondisi ini tidak mengubah hasilnya. Misalnya, mengambil cadangan atau mengubah kelas instans DB tidak mengubah hasilnya.

catatan

Precheck menjalankan pemeriksaan untuk versi mesin Anda saat ini. Itu tidak termasuk pemeriksaan yang bergantung pada versi yang Anda tingkatkan.