Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menjalankan prakontrol peningkatan versi minor di Amazon RDS untuk Oracle
Sebelum Amazon RDS for Oracle melakukan upgrade versi minor DB, Amazon RDS akan memeriksa apakah instance DB Anda berada dalam keadaan yang memungkinkan pemutakhiran selesai. Jika pemeriksaan menemukan masalah, peningkatan 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 Amazon RDS rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. Pemeriksaan awal bersifat read-only. Itu tidak mengubah data atau konfigurasi Anda.
Prosedur mengembalikan ID tugas. Precheck menulis hasilnya ke file log bernama dbtask- di direktori BDUMP. Untuk mengunduh file log, lihat Mengunduh file log basis data.task_id.log
catatan
Jalankan precheck pada instance DB utama Anda. Menjalankan precheck pada replika baca tidak didukung.
Topik
Menjalankan precheck peningkatan versi minor
Untuk memeriksa apakah instance DB Anda siap untuk upgrade versi minor DB, jalankan prosedur rdsadmin.rdsadmin_precheck_tasks.precheck_minor_upgrade. Prosedur tidak menggunakan parameter. Kueri 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.
Pracheck berjalan di latar belakang. Ini selesai ketika baris terakhir dari log The task finished successfully. atau The task
failed.
Melihat hasil precheck
Untuk membaca file log, jalankan prosedur Amazon RDS rdsadmin.rds_file_util.read_text_file. Sertakan ID tugas dalam nama file. Contoh berikut menunjukkan precheck di mana tidak ada pemeriksaan yang 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 mencantumkan file di direktori BDUMP, jalankan query berikut.
SELECT * FROM table(rdsadmin.rds_file_util.listdir('BDUMP')) order by mtime;
Untuk informasi lebih lanjut tentang prosedur rdsadmin.rds_file_util.read_text_file, lihat Membaca file di direktori instans DB.
Menafsirkan hasil precheck
Log memiliki satu CHECK: baris untuk setiap cek, diikuti oleh Summary: garis dan a Result: garis. Pemeriksaan mana yang dijalankan tergantung pada versi mesin Anda, arsitektur database Anda, dan konfigurasi instance DB Anda. Setiap pemeriksaan melaporkan salah satu hasil berikut:
PASSED-
Pemeriksaan tidak menemukan masalah.
FAILED [BLOCKER]-
Pemeriksaan menemukan masalah yang harus Anda perbaiki sebelum upgrade versi minor DB. Baris tersebut menjelaskan 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-
Pemeriksaan tidak bisa selesai. Jalankan precheck lagi.
Setiap pemeriksaan berjalan, bahkan ketika pemeriksaan sebelumnya gagal, jadi satu kali menjalankan melaporkan setiap masalah yang ditemukan precheck. Jika ada laporan cek FAILED [BLOCKER] atau ERROR, log menunjukkan Result: FAILED. Jika tidak, itu menunjukkan Result: 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 instance DB Anda lulus.
Apa yang diperiksa oleh precheck
Tabel berikut mencantumkan setiap pemeriksaan dan kondisi yang membuatnya gagal. Ketika pemeriksaan gagal, barisnya di log menjelaskan masalah dan cara memperbaikinya.
| Periksa | Gagal ketika |
|---|---|
FreeStorageSpace |
Instans DB memiliki penyimpanan gratis kurang dari 768 MB. |
SystemTablespace |
Yang SYSTEM atau SYSAUX tablespace memiliki ruang kosong kurang dari 300 MB, atau tidak dapat diperluas secara otomatis. Untuk CDB, precheck memeriksa setiap wadah. |
AuditTablespace |
Ruang tabel audit memiliki ruang kosong kurang dari 300 MB, atau tidak dapat diperluas secara otomatis. |
RedoApplyLag |
Jeda penerapan ulang replika baca lebih dari 5 menit. Dilewati jika instance DB tidak memiliki replika baca. |
MdsysUser |
Yang MDSYS pengguna tidak Oracle-maintained. |
ConflictingSynonyms |
Sinonim menggunakan nama yang disediakan versi Oracle baru. |
WorkspaceManager |
Manajer Ruang Kerja (WMSYS) objek ada. |
SchemaVersionRegistry |
Satu atau lebih SCHEMA_VERSION_REGISTRY Tampilan tidak valid. |
XmlDbSchema |
Satu atau lebih objek skema XML DB tidak valid. |
ApexStatus |
Komponen APEX tidak ada dalam VALID negara. |
CtxsysSequences |
CTXSYS skema tidak memiliki 3 urutan Teks Oracle (DR_ID_SEQ, MESG_ID_SEQ, THS_SEQ). Dilompati untuk CDB. |
InvalidSystemObjects |
Oracle-maintained Objek tidak valid. |
InvalidTriggers |
Pemicu tidak valid. |
PendingDistributedTransactions |
Transaksi terdistribusi belum terselesaikan. |
Kapan menjalankan precheck
Beberapa kondisi berubah seiring waktu, seperti penyimpanan gratis dan lag replika baca. Jalankan precheck sesaat sebelum Anda meningkatkan. Jika instans DB Anda menggunakan peningkatan versi minor otomatis, jalankan pemeriksaan awal 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, melepas atau mengkompilasi ulang objek, atau menyelesaikan transaksi terdistribusi. Perubahan yang tidak mempengaruhi kondisi ini tidak mengubah hasilnya. Misalnya, mengambil cadangan atau mengubah kelas instance DB tidak mengubah hasilnya.
catatan
Pracheck menjalankan pemeriksaan untuk versi mesin Anda saat ini. Ini tidak termasuk pemeriksaan yang bergantung pada versi yang Anda tingkatkan.
