Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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, lihat[Mengunduh file log basis data](USER_LogAccess.Procedural.Downloading.md).
**catatan**
Jalankan precheck pada instans DB utama Anda. Menjalankan prechecks pada replika baca tidak didukung.
**Topics**
+ [Menjalankan precheck upgrade versi minor](#USER_UpgradeDBInstance.Oracle.Precheck.Running)
+ [Melihat hasil precheck](#USER_UpgradeDBInstance.Oracle.Precheck.Viewing)
+ [Menafsirkan hasil precheck](#USER_UpgradeDBInstance.Oracle.Precheck.Interpreting)
+ [Apa yang diperiksa precheck](#USER_UpgradeDBInstance.Oracle.Precheck.Checks)
+ [Kapan menjalankan precheck](#USER_UpgradeDBInstance.Oracle.Precheck.When)
## Menjalankan precheck upgrade versi minor
Untuk memeriksa apakah instans DB Anda siap untuk upgrade versi minor DB, jalankan prosedurnya`rdsadmin.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 ini`rdsadmin.rds_file_util.read_text_file`, lihat[Membaca file di direktori instans DB](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).
## 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]` atau`ERROR`, log akan ditampilkan`Result: FAILED`. Kalau 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 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.