

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Upgrade RDS untuk mesin PostgreSQL DB
<a name="USER_UpgradeDBInstance.PostgreSQL"></a>

Ada dua jenis peningkatan yang dapat Anda kelola untuk basis data PostgreSQL Anda:
+ Pembaruan sistem operasi – Terkadang, Amazon RDS mungkin perlu memperbarui sistem operasi yang mendasari basis data Anda untuk menerapkan perbaikan keamanan atau perubahan OS. Anda dapat memutuskan kapan Amazon RDS menerapkan pembaruan OS dengan menggunakan konsol RDS, AWS Command Line Interface (AWS CLI), atau RDS API. Untuk informasi selengkapnya tentang pembaruan OS, lihat [Menerapkan pembaruan ke instans DB](USER_UpgradeDBInstance.Maintenance.md#USER_UpgradeDBInstance.OSUpgrades).
+  Peningkatan mesin basis data – Ketika Amazon RDS mendukung versi baru mesin basis data, Anda dapat meningkatkan basis data Anda ke versi baru. 

Sebuah *database* dalam konteks ini adalah RDS untuk PostgreSQL DB instance atau DB cluster. Multi-AZ 

Ada dua jenis peningkatan mesin untuk basis data PostgreSQL: peningkatan versi mayor dan peningkatan versi minor.

**Peningkatan versi mayor**  
*Peningkatan versi mayor* dapat berisi perubahan basis data yang tidak memiliki kompatibilitas mundur dengan aplikasi yang ada. Oleh karena itu, Anda harus melakukan peningkatan versi mayor untuk basis data Anda secara manual. Anda dapat memulai upgrade versi mayor dengan memodifikasi instans DB atau Multi-AZ cluster DB Anda. Sebelum Anda melakukan peningkatan versi mayor, kami sarankan agar Anda mengikuti langkah-langkah yang dijelaskan dalam [Memilih versi utama untuk RDS untuk upgrade PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.md).  
Amazon RDS menangani peningkatan versi Multi-AZ utama dengan cara berikut:  
+ **Multi-AZ Penerapan instans DB** — Amazon RDS secara bersamaan meningkatkan instans utama dan instans siaga apa pun. Database Anda mungkin tidak tersedia selama beberapa menit saat pemutakhiran selesai. 
+ **Multi-AZ Penerapan cluster DB** — Amazon RDS secara bersamaan meningkatkan instance pembaca dan penulis. Database Anda mungkin tidak tersedia selama beberapa menit saat pemutakhiran selesai. 
Jika Anda memutakhirkan instans DB yang memiliki replika baca In-region, Amazon RDS akan meningkatkan replika bersama dengan instans DB utama.  
Amazon RDS tidak memutakhirkan replika baca cluster Multi-AZ DB. **Jika Anda melakukan upgrade versi utama dari cluster Multi-AZ DB, maka status replikasi replika bacanya berubah menjadi dihentikan.** Anda harus menghapus dan membuat ulang replika baca secara manual setelah peningkatan selesai.  
Anda dapat meminimalkan waktu henti yang diperlukan untuk peningkatan versi utama dengan menggunakan blue/green penerapan. Untuk informasi selengkapnya, lihat [Menggunakan Amazon RDS Blue/Green Aurora Deployment untuk pembaruan database](blue-green-deployments.md).

**Peningkatan versi minor**  
Sebaliknya, tingkatkan* versi minor* hanya menyertakan perubahan yang kompatibel dengan aplikasi yang ada. Anda dapat memulai peningkatan versi minor secara manual dengan memodifikasi basis data Anda. Atau, Anda dapat mengaktifkan opsi **pemutakhiran versi minor otomatis** saat membuat atau memodifikasi database. Tindakan ini akan membuat Amazon RDS secara otomatis meningkatkan basis data Anda setelah menguji dan menyetujui versi baru.   
Amazon RDS menangani peningkatan versi Multi-AZ minor dengan cara berikut:  
+ **Multi-AZ Penerapan instans DB** — Amazon RDS secara bersamaan meningkatkan instans utama dan instans siaga apa pun. Database Anda mungkin tidak tersedia selama beberapa menit saat pemutakhiran selesai. 
+ **Multi-AZ Penerapan cluster DB** — Amazon RDS meningkatkan instans DB pembaca satu per satu. Kemudian, salah satu instans basis data pembaca beralih menjadi instans basis data penulis baru. Amazon RDS kemudian memutakhirkan instance penulis lama (yang sekarang menjadi instance pembaca). Multi-AZ Cluster DB biasanya mengurangi waktu henti upgrade versi minor menjadi sekitar 35 detik. Ketika digunakan dengan RDS Proxy, mereka dapat mengurangi downtime menjadi satu detik atau kurang. Untuk informasi selengkapnya, lihat [Amazon RDS Proxy ](rds-proxy.md). [Sebagai alternatif, Anda dapat menggunakan proxy database open source seperti [ProxySQL](https://aws.amazon.com/blogs/database/achieve-one-second-or-less-of-downtime-with-proxysql-when-upgrading-amazon-rds-multi-az-deployments-with-two-readable-standbys/),, atau Advanced JDBC [PgBouncer](https://aws.amazon.com/blogs/database/fast-switchovers-with-pgbouncer-on-amazon-rds-multi-az-deployments-with-two-readable-standbys-for-postgresql/)Wrapper Driver.AWS](https://aws.amazon.com/blogs/database/achieve-one-second-or-less-downtime-with-the-advanced-jdbc-wrapper-driver-when-upgrading-amazon-rds-multi-az-db-clusters/)
Jika database Anda telah membaca replika, Anda harus terlebih dahulu memutakhirkan semua replika baca sebelum Anda meng-upgrade instance sumber atau cluster.  
Untuk informasi selengkapnya, lihat [Upgrade versi minor otomatis untuk RDS untuk PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.Minor.md). Untuk informasi tentang melakukan peningkatan versi minor secara manual, lihat [Meningkatkan versi mesin secara manual](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.Manual).

Untuk informasi selengkapnya tentang versi mesin basis data dan kebijakan untuk menghentikan penggunaan versi mesin basis data, lihat [Versi Mesin Basis Data](https://aws.amazon.com/rds/faqs/#Database_Engine_Versions) dalam FAQ Amazon RDS.

**Topics**
+ [Pertimbangan untuk upgrade PostgreSQL](#USER_UpgradeDBInstance.PostgreSQL.Considerations)
+ [Menemukan target peningkatan yang valid](#USER_UpgradeDBInstance.PostgreSQL.FindingTargets)
+ [Nomor versi PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.VersionID.md)
+ [Nomor versi RDS di RDS untuk PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.rds.version.md)
+ [Memilih versi utama untuk RDS untuk upgrade PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.md)
+ [Cara melakukan upgrade versi utama untuk RDS untuk PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.Process.md)
+ [Upgrade versi minor otomatis untuk RDS untuk PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.Minor.md)
+ [Meningkatkan ekstensi PostgreSQL di RDS untuk database PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.ExtensionUpgrades.md)
+ [Memantau RDS untuk upgrade mesin PostgreSQL dengan acara](USER_UpgradeDBInstance.PostgreSQL.Monitoring.md)

## Pertimbangan untuk upgrade PostgreSQL
<a name="USER_UpgradeDBInstance.PostgreSQL.Considerations"></a>

[Untuk memutakhirkan database Anda dengan aman, Amazon RDS menggunakan `pg_upgrade` utilitas yang dijelaskan dalam dokumentasi PostgreSQL](https://www.postgresql.org/docs/current/pgupgrade.html)

Amazon RDS mengambil dua snapshot DB selama proses peningkatan jika periode retensi cadangan Anda lebih besar dari 0. Snapshot DB pertama adalah snapshot dari basis data sebelum perubahan peningkatan dibuat. Jika peningkatan gagal untuk basis data Anda, Anda dapat memulihkan snapshot ini untuk membuat basis data yang menjalankan versi lama. Snapshot DB kedua diambil setelah peningkatan selesai. Snapshot DB ini dihapus secara otomatis setelah periode retensi cadangan berakhir.

**catatan**  
Amazon RDS mengambil snapshot DB selama proses peningkatan hanya jika Anda telah mengatur periode retensi cadangan untuk basis data Anda ke angka yang lebih besar dari 0. Untuk mengubah periode retensi cadangan untuk DB, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). Anda tidak dapat mengonfigurasi periode retensi cadangan khusus untuk klaster Multi-AZ DB.

Saat Anda melakukan peningkatan versi mayor pada instans DB, setiap replika baca dalam Wilayah juga otomatis ditingkatkan. Setelah alur kerja peningkatan dimulai, replika baca menunggu `pg_upgrade` untuk berhasil diselesaikan pada instans DB primer. Kemudian, tingkatkan instans DB primer menunggu peningkatan replika baca selesai. Anda akan mengalami pemadaman hingga peningkatan selesai. **Saat Anda melakukan upgrade versi utama dari cluster Multi-AZ DB, status replikasi replika bacanya berubah menjadi dihentikan.**

Setelah peningkatan selesai, Anda tidak dapat kembali ke versi mesin DB yang lebih lama. Jika Anda ingin kembali ke versi yang lebih lama, pulihkan snapshot DB yang diambil sebelum peningkatan untuk membuat basis data baru. 

## Menemukan target peningkatan yang valid
<a name="USER_UpgradeDBInstance.PostgreSQL.FindingTargets"></a>

Bila Anda menggunakan Konsol Manajemen AWS untuk meng-upgrade database, ini menunjukkan target upgrade valid untuk database. Anda juga dapat menggunakan AWS CLI perintah berikut untuk mengidentifikasi target pemutakhiran yang valid untuk database:

Untuk Linux, macOS, atau Unix:

```
aws rds describe-db-engine-versions \
  --engine postgres \
  --engine-version {{version-number}} \
  --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text
```

Untuk Windows:

```
aws rds describe-db-engine-versions ^
  --engine postgres ^
  --engine-version {{version-number}} ^
  --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text
```

Misalnya, untuk mengidentifikasi target pemutakhiran yang valid untuk database PostgreSQL versi 16.1, jalankan perintah berikut: AWS CLI 

Untuk Linux, macOS, atau Unix:

```
aws rds describe-db-engine-versions \
  --engine postgres \
  --engine-version 16.1 \
  --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text
```

Untuk Windows:

```
aws rds describe-db-engine-versions ^
  --engine postgres ^
  --engine-version 16.1 ^
  --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text
```