

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

# Pembaruan manajemen rencana kueri Aurora PostgreSQL
<a name="auroraqpm.updates"></a>

 AWS `apg_plan_mgmt`Ekstensi menyediakan cluster Aurora PostgreSQL DB Anda dengan fitur manajemen rencana kueri. Ini memungkinkan Anda mengelola rencana eksekusi kueri yang dihasilkan oleh pengoptimal untuk aplikasi SQL Anda demi stabilitas yang lebih baik dan mencegah regresi. Lihat informasi yang lebih lengkap di [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*. 

**Topics**
+ [PostgreSQL 17 versi](#auroraqpm-version17)
+ [PostgreSQL versi 16](#auroraqpm-version16)
+ [PostgreSQL versi 15](#auroraqpm-version15)
+ [PostgreSQL versi 14](#auroraqpm-version14)
+ [PostgreSQL versi 13](#auroraqpm-version13)
+ [PostgreSQL versi 12](#auroraqpm-version12)
+ [Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.3](#auroraqpm-version.23)
+ [Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.1](#auroraqpm-version.21)
+ [Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.0](#auroraqpm-version.20)
+ [Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 1.0.1](#auroraqpm-version.101)

## PostgreSQL 17 versi
<a name="auroraqpm-version17"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.9, 6 April 2026](#auroraqpm-version17-179)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.7, 18 Desember 2025](#auroraqpm-version17-177)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.5, 30 Juni 2025](#auroraqpm-version17-175)
+ [apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 17.4, 01 Mei 2025](#auroraqpm-version17-174)

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.9, 6 April 2026
<a name="auroraqpm-version17-179"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 17.9 meliputi:

**Perbaikan ekstensi**
+ Memperbaiki masalah dalam Manajemen Rencana Kueri yang menyebabkan rencana tidak ditangkap.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.7, 18 Desember 2025
<a name="auroraqpm-version17-177"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 17.7 meliputi:

**Perbaikan ekstensi**
+ Menambahkan peningkatan dalam Manajemen Rencana Kueri untuk secara otomatis menangkap kembali daftar parameter yang disimpan dari versi sebelumnya.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 17.5, 30 Juni 2025
<a name="auroraqpm-version17-175"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 17.5 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan Pemindaian Bitmap Paralel saat BitmapOr/BitmapAnd operator hadir.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan rencana di mana beberapa partisi tabel digabungkan ke satu partisi tabel.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan node Append di atas partisi tabel tunggal.
+ `apg_plan_mgmt`Peran dalam manajemen rencana kueri dicadangkan dan tidak dapat lagi dibuat, diubah, atau dijatuhkan oleh pengguna.
+ Memperbaiki masalah dalam menangani daftar parameter dari versi manajemen rencana kueri sebelumnya.

### apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 17.4, 01 Mei 2025
<a name="auroraqpm-version17-174"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.8 untuk Aurora PostgreSQL 17.4 meliputi:

**Fitur baru**
+ Manajemen rencana kueri dapat menegakkan rencana yang memiliki transformasi subquery yang berkorelasi.
+ Manajemen rencana kueri dapat menegakkan rencana yang memiliki cache subquery yang berkorelasi.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan daftar parameter yang menyebabkan kesalahan atau memulai ulang saat menanyakan `dba_plans` tampilan atau panggilan `validate_plans` dan `evolve_plan_baselines` fungsi dalam manajemen paket Kueri. 
+ Memperbaiki masalah dengan penegakan rencana yang dioptimalkan dengan mengkorelasikan transformasi apa pun dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan menjalankan pernyataan utilitas segera setelah menginstal ekstensi atau mengatur ulang memori bersama.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana untuk kueri dengan panggilan ke fungsi yang tidak dapat diubah dalam manajemen rencana kueri.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana dalam manajemen rencana kueri.

## PostgreSQL versi 16
<a name="auroraqpm-version16"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.13, 6 April 2026](#auroraqpm-version16-1613)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.11, 18 Desember 2025](#auroraqpm-version16-1611)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.9, 30 Juni 2025](#auroraqpm-version16-169)
+ [apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 16.8, 8 April 2025](#auroraqpm-version16-168)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 16.6, 27 Desember 2024](#auroraqpm-version16-166)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 16.3](#auroraqpm-version16-163)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 16.2](#auroraqpm-version16-162)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 16.1](#auroraqpm-version16-161)

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.13, 6 April 2026
<a name="auroraqpm-version16-1613"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 16.13 meliputi:

**Perbaikan ekstensi**
+ Memperbaiki masalah dalam Manajemen Rencana Kueri yang menyebabkan rencana tidak ditangkap.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.11, 18 Desember 2025
<a name="auroraqpm-version16-1611"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 16.11 meliputi:

**Perbaikan ekstensi**
+ Menambahkan peningkatan dalam Manajemen Rencana Kueri untuk secara otomatis menangkap kembali daftar parameter yang disimpan dari versi sebelumnya.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 16.9, 30 Juni 2025
<a name="auroraqpm-version16-169"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 16.9 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan Pemindaian Bitmap Paralel saat BitmapOr/BitmapAnd operator hadir.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan rencana di mana beberapa partisi tabel digabungkan ke satu partisi tabel.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan node Append di atas partisi tabel tunggal.
+ `apg_plan_mgmt`Peran dalam manajemen rencana kueri dicadangkan dan tidak dapat lagi dibuat, diubah, atau dijatuhkan oleh pengguna.
+ Memperbaiki masalah dalam menangani daftar parameter dari versi manajemen rencana kueri sebelumnya.

### apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 16.8, 8 April 2025
<a name="auroraqpm-version16-168"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.8 untuk Aurora PostgreSQL 16.8 meliputi:

**Fitur baru**
+ Manajemen rencana kueri dapat menegakkan rencana yang memiliki transformasi subquery yang berkorelasi.
+ Manajemen rencana kueri dapat menegakkan rencana yang memiliki cache subquery yang berkorelasi.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan daftar parameter yang menyebabkan kesalahan atau memulai ulang saat menanyakan `dba_plans` tampilan atau panggilan `validate_plans` dan `evolve_plan_baselines` fungsi dalam manajemen paket Kueri. 
+ Memperbaiki masalah dengan penegakan rencana yang dioptimalkan dengan mengkorelasikan transformasi apa pun dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam manajemen paket Kueri dengan menjalankan pernyataan utilitas segera setelah menginstal ekstensi atau mengatur ulang memori bersama.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana untuk kueri dengan panggilan ke fungsi yang tidak dapat diubah dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana dalam manajemen rencana Kueri.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 16.6, 27 Desember 2024
<a name="auroraqpm-version16-166"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 16.6 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan pengambilan rencana pada replika dalam manajemen rencana kueri di mana array memori bersama dalam replika akan menjadi penuh.
+ Memperbaiki masalah dengan pekerja latar belakang manajemen rencana kueri yang menyebabkan periode retensi rencana tidak diberlakukan dan tanggal terakhir yang digunakan tidak diperbarui.
+ Memperbaiki masalah yang terkait dengan pekerja latar belakang manajemen rencana kueri.
+ Memperbaiki masalah dengan penegakan rencana manajemen rencana kueri yang berisi pemindaian bitmap.
+ Memperbaiki masalah dengan manajemen rencana kueri di mana rencana ditangkap secara tidak benar untuk fungsi atau prosedur dengan beberapa kueri.
+ Memperbaiki masalah dengan menangkap rencana eksekusi kueri bersarang dalam manajemen rencana kueri. 
+ Memperbaiki masalah dengan menangkap rencana dalam manajemen rencana kueri dengan protokol kueri yang diperluas. 

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 16.3
<a name="auroraqpm-version16-163"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 16.3 meliputi:

**Fitur baru**
+ Anda tidak perlu lagi memperbarui`plan_hash_version`. Setelah memutakhirkan mesin database, QPM secara otomatis mengaktifkan fitur baru. Anda tidak perlu mengambil tindakan apa pun agar fitur baru tersedia.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi lebih dari 64 tabel yang dipartisi.
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi operator Append.
+ Memperbaiki masalah dengan QPM validate\_plans dengan tindakan update\_plan\_hash.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 16.2
<a name="auroraqpm-version16-162"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 16.2 meliputi:

**Fitur baru**
+ QPM dapat menegakkan rencana yang memiliki operator Agregat.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah saat menjatuhkan database tidak menghapus paket yang diambil terkait dari memori bersama.
+ Memperbaiki masalah dengan penegakan rencana yang berisi tampilan.
+ Perbaikan dalam penegakan rencana Append Paralel.
+ Memperbaiki masalah yang terkait dengan pengambilan rencana.
+ Memperbaiki masalah dengan penegakan rencana yang berisi node pengumpulan.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 16.1
<a name="auroraqpm-version16-161"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 16.1 meliputi:

**Fitur baru**
+ Garis besar rencana akan diperbarui ke versi format terbaru sebagai bagian dari tindakan `update_plan_hash` untuk fungsi `apg_plan_mgmt.validate_plans`.
+ Penambahan dukungan untuk Penegakan penambahan paralel sebagai bagian dari Penegakan Kueri Paralel. Untuk menerapkan simpul penambahan paralel dengan benar, Anda harus melakukan hal berikut:

  1. Atur `apg_plan_mgmt.plan_hash_version` ke 5.

  1. Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan performa dalam penghitungan hash rencana. 
+ Peningkatan pemanfaatan memori untuk garis besar rencana yang berisi subrencana berulang.
+ Memperbaiki masalah dalam penegakan kueri paralel di mana `GatherMerge` tidak dapat ditegakkan.
+ Memperbaiki masalah di mana perkiraan biaya rencana yang ditegakkan tidak benar.
+ Memperbaiki masalah dalam penegakan rencana yang disetujui di mana garis besar berisi tabel dan subrencana yang dipartisi.

## PostgreSQL versi 15
<a name="auroraqpm-version15"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.17, 6 April 2026](#auroraqpm-version15-1517)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.15, 18 Desember 2025](#auroraqpm-version15-1515)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.13, 30 Juni 2025](#auroraqpm-version15-1513)
+ [apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 15.12, 8 April 2025](#auroraqpm-version15-1512)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.10, 27 Desember 2024](#auroraqpm-version15-1510)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.8, 30 September 2024](#auroraqpm-version15-158)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.7, 8 Agustus 2024](#auroraqpm-version15-157)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 15.6](#auroraqpm-version15-156)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 15.5](#auroraqpm-version15-155)
+ [apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 15.4](#auroraqpm-version15-154)
+ [apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 15.3](#auroraqpm-version15-153)

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.17, 6 April 2026
<a name="auroraqpm-version15-1517"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 15.17 meliputi:

**Perbaikan ekstensi**
+ Memperbaiki masalah dalam Manajemen Rencana Kueri yang menyebabkan rencana tidak ditangkap.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.15, 18 Desember 2025
<a name="auroraqpm-version15-1515"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 15.15 meliputi:

**Perbaikan ekstensi**
+ Menambahkan peningkatan dalam Manajemen Rencana Kueri untuk secara otomatis menangkap kembali daftar parameter yang disimpan dari versi sebelumnya.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 15.13, 30 Juni 2025
<a name="auroraqpm-version15-1513"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 15.13 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan Pemindaian Bitmap Paralel saat BitmapOr/BitmapAnd operator hadir.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan rencana di mana beberapa partisi tabel digabungkan ke satu partisi tabel.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan node Append di atas partisi tabel tunggal.
+ `apg_plan_mgmt`Peran dalam manajemen rencana kueri dicadangkan dan tidak dapat lagi dibuat, diubah, atau dijatuhkan oleh pengguna.
+ Memperbaiki masalah dalam menangani daftar parameter dari versi manajemen rencana kueri sebelumnya.

### apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 15.12, 8 April 2025
<a name="auroraqpm-version15-1512"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.8 untuk Aurora PostgreSQL 15.12 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan daftar parameter yang menyebabkan kesalahan atau memulai ulang saat menanyakan `dba_plans` tampilan atau panggilan `validate_plans` dan `evolve_plan_baselines` fungsi dalam manajemen paket Kueri. 
+ Memperbaiki masalah dengan penegakan rencana yang dioptimalkan dengan mengkorelasikan transformasi apa pun dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam manajemen paket Kueri dengan menjalankan pernyataan utilitas segera setelah menginstal ekstensi atau mengatur ulang memori bersama.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana untuk kueri dengan panggilan ke fungsi yang tidak dapat diubah dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana dalam manajemen rencana Kueri.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.10, 27 Desember 2024
<a name="auroraqpm-version15-1510"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 15.10 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan pengambilan rencana pada replika dalam manajemen rencana kueri di mana array memori bersama dalam replika akan menjadi penuh.
+ Memperbaiki masalah dengan pekerja latar belakang manajemen rencana kueri yang menyebabkan periode retensi rencana tidak diberlakukan dan tanggal terakhir yang digunakan tidak diperbarui.
+ Memperbaiki masalah yang terkait dengan pekerja latar belakang manajemen rencana kueri.
+ Memperbaiki masalah dengan penegakan rencana manajemen rencana kueri yang berisi pemindaian bitmap.
+ Memperbaiki masalah dengan manajemen rencana kueri di mana rencana ditangkap secara tidak benar untuk fungsi atau prosedur dengan beberapa kueri.
+ Memperbaiki masalah dengan menangkap rencana eksekusi kueri bersarang dalam manajemen rencana kueri. 
+ Memperbaiki masalah dengan menangkap rencana dalam manajemen rencana kueri dengan protokol kueri yang diperluas. 

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.8, 30 September 2024
<a name="auroraqpm-version15-158"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 15.8 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana Manajemen Rencana Kueri yang berisi Agregat Hash.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 15.7, 8 Agustus 2024
<a name="auroraqpm-version15-157"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 15.7 meliputi:

**Fitur baru**
+ Anda tidak perlu lagi memperbarui`plan_hash_version`. Setelah memutakhirkan mesin database, QPM secara otomatis mengaktifkan fitur baru. Anda tidak perlu mengambil tindakan apa pun agar fitur baru tersedia.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi lebih dari 64 tabel yang dipartisi.
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi operator Append.
+ Memperbaiki masalah dengan QPM validate\_plans dengan tindakan update\_plan\_hash.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 15.6
<a name="auroraqpm-version15-156"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 15.6 meliputi:

**Fitur baru**
+ QPM dapat menegakkan rencana yang memiliki operator Agregat.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah saat menjatuhkan database tidak menghapus paket yang diambil terkait dari memori bersama.
+ Memperbaiki masalah dengan penegakan rencana yang berisi tampilan.
+ Perbaikan dalam penegakan rencana Append Paralel.
+ Memperbaiki masalah yang terkait dengan pengambilan rencana.
+ Memperbaiki masalah dengan penegakan rencana yang berisi node pengumpulan.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 15.5
<a name="auroraqpm-version15-155"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 15.5 meliputi:

**Fitur baru**
+ Garis besar rencana akan diperbarui ke versi format terbaru sebagai bagian dari tindakan `update_plan_hash` untuk fungsi `apg_plan_mgmt.validate_plans`.
+ Penambahan dukungan untuk Penegakan penambahan paralel sebagai bagian dari Penegakan Kueri Paralel. Untuk menerapkan simpul penambahan paralel dengan benar, Anda harus melakukan hal berikut:

  1. Atur `apg_plan_mgmt.plan_hash_version` ke 5.

  1. Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan performa dalam penghitungan hash rencana. 
+ Peningkatan pemanfaatan memori untuk garis besar rencana yang berisi subrencana berulang.
+ Memperbaiki masalah dalam penegakan kueri paralel di mana `GatherMerge` tidak dapat ditegakkan.
+ Memperbaiki masalah di mana perkiraan biaya rencana yang ditegakkan tidak benar.
+ Memperbaiki masalah dalam penegakan rencana yang disetujui di mana garis besar berisi tabel dan subrencana yang dipartisi.

### apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 15.4
<a name="auroraqpm-version15-154"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.5 untuk Aurora PostgreSQL 15.4 meliputi:

**Fitur baru**
+ QPM dapat memaksa rencana kueri agar memiliki operator paralel kecuali simpul Append Parallel. Untuk menerapkan rencana kueri paralel dengan benar, Anda harus melakukan hal-hal berikut setelah memutakhirkan ke 15.4 atau 14.9:
  + Setel `apg_plan_mgmt.plan_hash_version` ke 4 atau lebih tinggi.
  + Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.
  + Re-capture rencana yang disetujui yang memiliki Gather node di plan\_outline.
+ QPM dapat menerapkan rencana kueri dengan simpul Materialize. Untuk menerapkan simpul Materialize, Anda harus melakukan hal-hal berikut setelah memutakhirkan ke 15.4 atau 14.9:
  + Setel `apg_plan_mgmt.plan_hash_version` ke 4 atau lebih tinggi.
  + Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Untuk menangkap rencana kueri dari Replicas, Anda harus memperbarui ekstensi `apg_plan_mgmt` dengan memanggil ALTER EXTENSION apg\_plan\_mgmt UPDATE. 
+ Anda perlu menentukan `apg_plan_mgmt.plan_capture_threshold` agar tidak mengizinkan QPM untuk menangkap rencana kueri apa pun.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan kinerja pada `plan_hash` perhitungan.

### apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 15.3
<a name="auroraqpm-version15-153"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.4 untuk Aurora PostgreSQL 15.3 meliputi:

**Fitur baru**
+ Memperkenalkan GUC baru auto\_explain.hashes. Apabila diatur ke true (default: false), sql\_hash dan plan\_hash ditampilkan di akhir hasil penjelasan otomatis. 
+ Memperkenalkan GUC baru apg\_plan\_mgmt.explain\_hashes. Apabila diatur ke true (default: false), hasil EXPLAIN menunjukkan sql\_hash dan plan\_hash sekalipun tanpa opsi hash true.
+ Memperkenalkan GUC baru apg\_plan\_mgmt.log\_plan\_enforcement\_result. Bergantung pada nilainya (default: none (tidak ada)), hasil penegakan rencana ditulis ke file log Postgres.
+ Memperkenalkan versi perhitungan hash rencana baru untuk mendukung tabel terpartisi. Pengguna perlu mengatur apg\_plan\_mgmt.plan\_hash\_version ke 3 dan memanggil apg\_plan\_mgmt.validate\_plans ('update\_plan\_hash') di setiap basis data dengan `apg_plan_mgmt` diinstal dan entri-entri dalam tabel rencana.
+ QPM dapat menerapkan rencana kueri dengan simpul Memoize.
+  Fungsi `apg_plan_mgmt.copy_outline` dapat mengambil argumen ke-5 baru, `force_update_target_plan_hash`. Jika diatur ke true, hash rencana target akan diperbarui meskipun rencana sumber tidak dapat direproduksi untuk sql\_hash target. 

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana pernyataan yang disiapkan JDBC.
+ Paritas yang meningkat tentang queryid antara pg\_stat\_statements dan apg\_plan\_mgmt.dba\_plans.
+ Memperbaiki masalah penegakan rencana apabila nama indeks berakhir dengan angka. 
+  Fungsi apg\_plan\_mgmt.copy\_outline kini menyalin environment\_variables. 
+  Nilai minimum apg\_plan\_mgmt.plan\_retention\_period berubah dari 32 menjadi 1. 
+  Pengelolaan rencana kueri kini dapat menyimpan rencana untuk kueri dalam transaksi hanya-baca dari simpul penulis. 
+  Memperbaiki masalah dalam fungsi apg\_plan\_mgmt.evolve\_plan\_baselines. 
+  Memperbaiki masalah yang dapat menyebabkan ketidaktersediaan saat apg\_plan\_mgmt diaktifkan. 

Untuk mempelajari cara menginstal, memutakhirkan, dan menggunakan ekstensi `apg_plan_mgmt`, lihat [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*.

## PostgreSQL versi 14
<a name="auroraqpm-version14"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.22, 6 April 2026](#auroraqpm-version14-1422)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.20, 18 Desember 2025](#auroraqpm-version14-1420)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.18, 30 Juni 2025](#auroraqpm-version14-1418)
+ [apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 14.17, 8 April 2025](#auroraqpm-version14-1417)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 14.15, 27 Desember 2024](#auroraqpm-version14-1415)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 14.12, 8 Agustus 2024](#auroraqpm-version14-1412)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 14.11](#auroraqpm-version14-1411)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 14.10](#auroraqpm-version14-1410)
+ [apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 14.9](#auroraqpm-version14-149)
+ [apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 14.8](#auroraqpm-version14-148)

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.22, 6 April 2026
<a name="auroraqpm-version14-1422"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 14.22 meliputi:

**Perbaikan ekstensi**
+ Memperbaiki masalah dalam Manajemen Rencana Kueri yang menyebabkan rencana tidak ditangkap.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.20, 18 Desember 2025
<a name="auroraqpm-version14-1420"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 14.20 meliputi:

**Perbaikan ekstensi**
+ Menambahkan peningkatan dalam Manajemen Rencana Kueri untuk secara otomatis menangkap kembali daftar parameter yang disimpan dari versi sebelumnya.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 14.18, 30 Juni 2025
<a name="auroraqpm-version14-1418"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 14.18 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan Pemindaian Bitmap Paralel saat BitmapOr/BitmapAnd operator hadir.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan rencana di mana beberapa partisi tabel digabungkan ke satu partisi tabel.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan node Append di atas partisi tabel tunggal.
+ `apg_plan_mgmt`Peran dalam manajemen rencana kueri dicadangkan dan tidak dapat lagi dibuat, diubah, atau dijatuhkan oleh pengguna.
+ Memperbaiki masalah dalam menangani daftar parameter dari versi manajemen rencana kueri sebelumnya.

### apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 14.17, 8 April 2025
<a name="auroraqpm-version14-1417"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.8 untuk Aurora PostgreSQL 14.17 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan daftar parameter yang menyebabkan kesalahan atau memulai ulang saat menanyakan `dba_plans` tampilan atau panggilan `validate_plans` dan `evolve_plan_baselines` fungsi dalam manajemen paket Kueri. 
+ Memperbaiki masalah dengan penegakan rencana yang dioptimalkan dengan mengkorelasikan transformasi apa pun dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam manajemen paket Kueri dengan menjalankan pernyataan utilitas segera setelah menginstal ekstensi atau mengatur ulang memori bersama.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana untuk kueri dengan panggilan ke fungsi yang tidak dapat diubah dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana dalam manajemen rencana Kueri.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 14.15, 27 Desember 2024
<a name="auroraqpm-version14-1415"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 14.15 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan pengambilan rencana pada replika dalam manajemen rencana kueri di mana array memori bersama dalam replika akan menjadi penuh.
+ Memperbaiki masalah dengan pekerja latar belakang manajemen rencana kueri yang menyebabkan periode retensi rencana tidak diberlakukan dan tanggal terakhir yang digunakan tidak diperbarui.
+ Memperbaiki masalah yang terkait dengan pekerja latar belakang manajemen rencana kueri.
+ Memperbaiki masalah dengan penegakan rencana manajemen rencana kueri yang berisi pemindaian bitmap.
+ Memperbaiki masalah dengan manajemen rencana kueri di mana rencana ditangkap secara tidak benar untuk fungsi atau prosedur dengan beberapa kueri.
+ Memperbaiki masalah dengan menangkap rencana eksekusi kueri bersarang dalam manajemen rencana kueri. 
+ Memperbaiki masalah dengan menangkap rencana dalam manajemen rencana kueri dengan protokol kueri yang diperluas. 

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 14.12, 8 Agustus 2024
<a name="auroraqpm-version14-1412"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 14.12 meliputi:

**Fitur baru**
+ Anda tidak perlu lagi memperbarui`plan_hash_version`. Setelah memutakhirkan mesin database, QPM secara otomatis mengaktifkan fitur baru. Anda tidak perlu mengambil tindakan apa pun agar fitur baru tersedia.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi lebih dari 64 tabel yang dipartisi.
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi operator Append.
+ Memperbaiki masalah dengan QPM validate\_plans dengan tindakan update\_plan\_hash.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 14.11
<a name="auroraqpm-version14-1411"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 14.11 meliputi:

**Fitur baru**
+ QPM dapat menegakkan rencana yang memiliki operator Agregat.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah saat menjatuhkan database tidak menghapus paket yang diambil terkait dari memori bersama.
+ Memperbaiki masalah dengan penegakan rencana yang berisi tampilan.
+ Perbaikan dalam penegakan rencana Append Paralel.
+ Memperbaiki masalah yang terkait dengan pengambilan rencana.
+ Memperbaiki masalah dengan penegakan rencana yang berisi node pengumpulan.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 14.10
<a name="auroraqpm-version14-1410"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 14.10 meliputi:

**Fitur baru**
+ Garis besar rencana akan diperbarui ke versi format terbaru sebagai bagian dari tindakan `update_plan_hash` untuk fungsi `apg_plan_mgmt.validate_plans`.
+ Penambahan dukungan untuk Penegakan penambahan paralel sebagai bagian dari Penegakan Kueri Paralel. Untuk menerapkan simpul penambahan paralel dengan benar, Anda harus melakukan hal berikut:

  1. Atur `apg_plan_mgmt.plan_hash_version` ke 5.

  1. Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan performa dalam penghitungan hash rencana. 
+ Peningkatan pemanfaatan memori untuk garis besar rencana yang berisi subrencana berulang.
+ Memperbaiki masalah dalam penegakan kueri paralel di mana `GatherMerge` tidak dapat ditegakkan.
+ Memperbaiki masalah di mana perkiraan biaya rencana yang ditegakkan tidak benar.
+ Memperbaiki masalah dalam penegakan rencana yang disetujui di mana garis besar berisi tabel dan subrencana yang dipartisi.

### apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 14.9
<a name="auroraqpm-version14-149"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.5 untuk Aurora PostgreSQL 14.9 meliputi:

**Fitur baru**
+ QPM dapat memaksa rencana kueri agar memiliki operator paralel kecuali simpul Append Parallel. Untuk menerapkan rencana kueri paralel dengan benar, Anda harus melakukan hal-hal berikut setelah memutakhirkan ke 15.4 atau 14.9:
  + Setel `apg_plan_mgmt.plan_hash_version` ke 4 atau lebih tinggi.
  + Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.
  + Re-capture rencana yang disetujui yang memiliki Gather node di plan\_outline.
+ QPM dapat menerapkan rencana kueri dengan simpul Materialize. Untuk menerapkan simpul Materialize, Anda harus melakukan hal-hal berikut setelah memutakhirkan ke 15.4 atau 14.9:
  + Setel `apg_plan_mgmt.plan_hash_version` ke 4 atau lebih tinggi.
  + Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Untuk menangkap rencana kueri dari Replicas, Anda harus memperbarui ekstensi `apg_plan_mgmt` dengan memanggil ALTER EXTENSION apg\_plan\_mgmt UPDATE. 
+ Anda perlu menentukan `apg_plan_mgmt.plan_capture_threshold` agar tidak mengizinkan QPM untuk menangkap rencana kueri apa pun.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan kinerja pada `plan_hash` perhitungan.

### apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 14.8
<a name="auroraqpm-version14-148"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.4 untuk Aurora PostgreSQL 14.8 meliputi:

**Fitur baru**
+ Memperkenalkan GUC baru auto\_explain.hashes. Apabila diatur ke true (default: false), sql\_hash dan plan\_hash ditampilkan di akhir hasil penjelasan otomatis. 
+ Memperkenalkan GUC baru apg\_plan\_mgmt.explain\_hashes. Apabila diatur ke true (default: false), hasil EXPLAIN menunjukkan sql\_hash dan plan\_hash sekalipun tanpa opsi hash true.
+ Memperkenalkan GUC baru apg\_plan\_mgmt.log\_plan\_enforcement\_result. Bergantung pada nilainya (default: none (tidak ada)), hasil penegakan rencana ditulis ke file log Postgres.
+ Memperkenalkan versi perhitungan hash rencana baru untuk mendukung tabel terpartisi. Pengguna perlu mengatur apg\_plan\_mgmt.plan\_hash\_version ke 3 dan memanggil apg\_plan\_mgmt.validate\_plans ('update\_plan\_hash') di setiap basis data dengan `apg_plan_mgmt` diinstal dan entri-entri dalam tabel rencana.
+ QPM dapat menerapkan rencana kueri dengan simpul Memoize.
+  Fungsi `apg_plan_mgmt.copy_outline` dapat mengambil argumen ke-5 baru, `force_update_target_plan_hash`. Jika diatur ke true, hash rencana target akan diperbarui meskipun rencana sumber tidak dapat direproduksi untuk sql\_hash target. 

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana pernyataan yang disiapkan JDBC.
+ Paritas yang meningkat tentang queryid antara pg\_stat\_statements dan apg\_plan\_mgmt.dba\_plans.
+ Memperbaiki masalah penegakan rencana apabila nama indeks berakhir dengan angka. 
+  Fungsi apg\_plan\_mgmt.copy\_outline kini menyalin environment\_variables. 
+  Nilai minimum apg\_plan\_mgmt.plan\_retention\_period berubah dari 32 menjadi 1. 
+  Pengelolaan rencana kueri kini dapat menyimpan rencana untuk kueri dalam transaksi hanya-baca dari simpul penulis. 
+  Memperbaiki masalah dalam fungsi apg\_plan\_mgmt.evolve\_plan\_baselines. 
+  Memperbaiki masalah yang dapat menyebabkan ketidaktersediaan saat apg\_plan\_mgmt diaktifkan. 

Untuk mempelajari cara menginstal, memutakhirkan, dan menggunakan ekstensi `apg_plan_mgmt`, lihat [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*.

## PostgreSQL versi 13
<a name="auroraqpm-version13"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 13.23, 18 Desember 2025](#auroraqpm-version13-1323)
+ [apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 13.21, 30 Juni 2025](#auroraqpm-version13-1321)
+ [apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 13.20, 8 April 2025](#auroraqpm-version13-1320)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 13.18, 27 Desember 2024](#auroraqpm-version13-1318)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 13.15, 8 Agustus 2024](#auroraqpm-version13-1315)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 13.14](#auroraqpm-version13-1314)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 13.13](#auroraqpm-version13-1313)
+ [apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 13.12](#auroraqpm-version13-1312)
+ [apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 13.11](#auroraqpm-version13-1311)

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 13.23, 18 Desember 2025
<a name="auroraqpm-version13-1323"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 13.23 meliputi:

**Perbaikan ekstensi**
+ Menambahkan peningkatan dalam Manajemen Rencana Kueri untuk secara otomatis menangkap kembali daftar parameter yang disimpan dari versi sebelumnya.

### apg\_plan\_mgmt versi 2.9 untuk Aurora PostgreSQL 13.21, 30 Juni 2025
<a name="auroraqpm-version13-1321"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.9 untuk Aurora PostgreSQL 13.21 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan Pemindaian Bitmap Paralel saat BitmapOr/BitmapAnd operator hadir.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan rencana di mana beberapa partisi tabel digabungkan ke satu partisi tabel.
+ Memperbaiki masalah dalam manajemen rencana kueri dengan penegakan node Append di atas partisi tabel tunggal.
+ `apg_plan_mgmt`Peran dalam Manajemen Rencana Kueri dicadangkan dan tidak dapat lagi dibuat, diubah, atau dijatuhkan oleh pengguna.
+ Memperbaiki masalah dalam menangani daftar parameter dari versi sebelumnya dari Query Plan Management.

### apg\_plan\_mgmt versi 2.8 untuk Aurora PostgreSQL 13.20, 8 April 2025
<a name="auroraqpm-version13-1320"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.8 untuk Aurora PostgreSQL 13.20 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan daftar parameter yang menyebabkan kesalahan atau memulai ulang saat menanyakan `dba_plans` tampilan atau panggilan `validate_plans` dan `evolve_plan_baselines` fungsi dalam manajemen paket Kueri. 
+ Memperbaiki masalah dengan penegakan rencana yang dioptimalkan dengan mengkorelasikan transformasi apa pun dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam manajemen paket Kueri dengan menjalankan pernyataan utilitas segera setelah menginstal ekstensi atau mengatur ulang memori bersama.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana untuk kueri dengan panggilan ke fungsi yang tidak dapat diubah dalam manajemen rencana Kueri.
+ Memperbaiki masalah dalam menegakkan, memvalidasi, dan mengembangkan rencana dalam manajemen rencana Kueri.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 13.18, 27 Desember 2024
<a name="auroraqpm-version13-1318"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 13.18 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan pengambilan rencana pada replika dalam manajemen rencana kueri di mana array memori bersama dalam replika akan menjadi penuh.
+ Memperbaiki masalah dengan pekerja latar belakang manajemen rencana kueri yang menyebabkan periode retensi rencana tidak diberlakukan dan tanggal terakhir yang digunakan tidak diperbarui.
+ Memperbaiki masalah yang terkait dengan pekerja latar belakang manajemen rencana kueri.
+ Memperbaiki masalah dengan penegakan rencana manajemen rencana kueri yang berisi pemindaian bitmap.
+ Memperbaiki masalah dengan manajemen rencana kueri di mana rencana ditangkap secara tidak benar untuk fungsi atau prosedur dengan beberapa kueri.
+ Memperbaiki masalah dengan menangkap rencana eksekusi kueri bersarang dalam manajemen rencana kueri. 
+ Memperbaiki masalah dengan menangkap rencana dalam manajemen rencana kueri dengan protokol kueri yang diperluas. 

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 13.15, 8 Agustus 2024
<a name="auroraqpm-version13-1315"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 13.15 meliputi:

**Fitur baru**
+ Anda tidak perlu lagi memperbarui`plan_hash_version`. Setelah memutakhirkan mesin database, QPM secara otomatis mengaktifkan fitur baru. Anda tidak perlu mengambil tindakan apa pun agar fitur baru tersedia.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi lebih dari 64 tabel yang dipartisi.
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi operator Append.
+ Memperbaiki masalah dengan QPM validate\_plans dengan tindakan update\_plan\_hash.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 13.14
<a name="auroraqpm-version13-1314"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 13.14 meliputi:

**Fitur baru**
+ QPM dapat menegakkan rencana yang memiliki operator Agregat.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah saat menjatuhkan database tidak menghapus paket yang diambil terkait dari memori bersama.
+ Memperbaiki masalah dengan penegakan rencana yang berisi tampilan.
+ Perbaikan dalam penegakan rencana Append Paralel.
+ Memperbaiki masalah yang terkait dengan pengambilan rencana.
+ Memperbaiki masalah dengan penegakan rencana yang berisi node pengumpulan.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 13.13
<a name="auroraqpm-version13-1313"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 13.13 meliputi:

**Fitur baru**
+ Garis besar rencana akan diperbarui ke versi format terbaru sebagai bagian dari tindakan `update_plan_hash` untuk fungsi `apg_plan_mgmt.validate_plans`.
+ Penambahan dukungan untuk Penegakan penambahan paralel sebagai bagian dari Penegakan Kueri Paralel. Untuk menerapkan simpul penambahan paralel dengan benar, Anda harus melakukan hal berikut:

  1. Atur `apg_plan_mgmt.plan_hash_version` ke 5.

  1. Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.

**Perbaikan dan penyempurnaan tambahan**
+ Peningkatan performa dalam penghitungan hash rencana. 
+ Peningkatan pemanfaatan memori untuk garis besar rencana yang berisi subrencana berulang.
+ Memperbaiki masalah dalam penegakan kueri paralel di mana `GatherMerge` tidak dapat ditegakkan.
+ Memperbaiki masalah di mana perkiraan biaya rencana yang ditegakkan tidak benar.
+ Memperbaiki masalah dalam penegakan rencana yang disetujui di mana garis besar berisi tabel dan subrencana yang dipartisi.

### apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 13.12
<a name="auroraqpm-version13-1312"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.5 untuk Aurora PostgreSQL 13.12 meliputi:

**Fitur baru**
+ QPM dapat memaksa rencana kueri agar memiliki operator paralel kecuali simpul Append Parallel. Untuk menerapkan rencana kueri paralel dengan benar, Anda harus melakukan hal-hal berikut setelah memutakhirkan ke 15.4 atau 14.9:
  + Setel `apg_plan_mgmt.plan_hash_version` ke 4 atau lebih tinggi.
  + Panggil `apg_plan_mgmt.validate_plans('update_plan_hash')`.
  + Re-capture rencana yang disetujui yang memiliki Gather node di plan\_outline.
+ Untuk menangkap rencana kueri dari Replicas, Anda harus memperbarui ekstensi `apg_plan_mgmt` dengan memanggil ALTER EXTENSION apg\_plan\_mgmt UPDATE. 
+ Anda perlu menentukan `apg_plan_mgmt.plan_capture_threshold` agar tidak mengizinkan QPM untuk menangkap rencana kueri apa pun.

### apg\_plan\_mgmt versi 2.4 untuk Aurora PostgreSQL 13.11
<a name="auroraqpm-version13-1311"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.4 untuk Aurora PostgreSQL 13.11 meliputi:

**Fitur baru**
+ Memperkenalkan GUC baru auto\_explain.hashes. Apabila diatur ke true (default: false), sql\_hash dan plan\_hash ditampilkan di akhir hasil penjelasan otomatis. 
+ Memperkenalkan GUC baru apg\_plan\_mgmt.explain\_hashes. Apabila diatur ke true (default: false), hasil EXPLAIN menunjukkan sql\_hash dan plan\_hash sekalipun tanpa opsi hash true.
+ Memperkenalkan GUC baru apg\_plan\_mgmt.log\_plan\_enforcement\_result. Bergantung pada nilainya (default: none (tidak ada)), hasil penegakan rencana ditulis ke file log Postgres.
+ Memperkenalkan versi perhitungan hash rencana baru untuk mendukung tabel terpartisi. Pengguna perlu mengatur apg\_plan\_mgmt.plan\_hash\_version ke 3 dan memanggil apg\_plan\_mgmt.validate\_plans ('update\_plan\_hash') di setiap basis data dengan `apg_plan_mgmt` diinstal dan entri-entri dalam tabel rencana.
+  Fungsi `apg_plan_mgmt.copy_outline` dapat mengambil argumen ke-5 baru, `force_update_target_plan_hash`. Jika diatur ke true, hash rencana target akan diperbarui meskipun rencana sumber tidak dapat direproduksi untuk sql\_hash target. 

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana pernyataan yang disiapkan JDBC.
+ Memperbaiki masalah penegakan rencana apabila nama indeks berakhir dengan angka. 
+  Fungsi apg\_plan\_mgmt.copy\_outline kini menyalin environment\_variables. 
+  Nilai minimum apg\_plan\_mgmt.plan\_retention\_period berubah dari 32 menjadi 1. 
+  Pengelolaan rencana kueri kini dapat menyimpan rencana untuk kueri dalam transaksi hanya-baca dari simpul penulis. 
+  Memperbaiki masalah dalam fungsi apg\_plan\_mgmt.evolve\_plan\_baselines. 
+  Memperbaiki masalah yang dapat menyebabkan ketidaktersediaan saat apg\_plan\_mgmt diaktifkan. 

Untuk mempelajari cara menginstal, memutakhirkan, dan menggunakan ekstensi `apg_plan_mgmt`, lihat [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*.

## PostgreSQL versi 12
<a name="auroraqpm-version12"></a>

**Topics**
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 12.22, 27 Desember 2024](#auroraqpm-version12-1222)
+ [apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 12.19, 8 Agustus 2024](#auroraqpm-version12-1219)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 12.18](#auroraqpm-version12-1218)
+ [apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 12.17](#auroraqpm-version12-1217)
+ [apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 12.16](#auroraqpm-version12-1216)

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 12.22, 27 Desember 2024
<a name="auroraqpm-version12-1222"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 12.22 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan pengambilan rencana pada replika dalam manajemen rencana kueri di mana array memori bersama dalam replika akan menjadi penuh.
+ Memperbaiki masalah dengan pekerja latar belakang manajemen rencana kueri yang menyebabkan periode retensi rencana tidak diberlakukan dan tanggal terakhir yang digunakan tidak diperbarui.
+ Memperbaiki masalah yang terkait dengan pekerja latar belakang manajemen rencana kueri.

### apg\_plan\_mgmt versi 2.7 untuk Aurora PostgreSQL 12.19, 8 Agustus 2024
<a name="auroraqpm-version12-1219"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.7 untuk Aurora PostgreSQL 12.19 meliputi:

**Fitur baru**
+ Anda tidak perlu lagi memperbarui`plan_hash_version`. Setelah memutakhirkan mesin database, QPM secara otomatis mengaktifkan fitur baru. Anda tidak perlu mengambil tindakan apa pun agar fitur baru tersedia.

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi lebih dari 64 tabel yang dipartisi.
+ Memperbaiki masalah dengan penegakan rencana QPM yang berisi operator Append.
+ Memperbaiki masalah dengan QPM validate\_plans dengan tindakan update\_plan\_hash.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 12.18
<a name="auroraqpm-version12-1218"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 12.18 meliputi:

**Perbaikan dan penyempurnaan tambahan**
+ Memperbaiki masalah yang terkait dengan pengambilan rencana.

### apg\_plan\_mgmt versi 2.6 untuk Aurora PostgreSQL 12.17
<a name="auroraqpm-version12-1217"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.6 untuk Aurora PostgreSQL 12.17 meliputi:

**Fitur baru**
+ Garis besar rencana akan diperbarui ke versi format terbaru sebagai bagian dari tindakan `update_plan_hash` untuk fungsi `apg_plan_mgmt.validate_plans`.

### apg\_plan\_mgmt versi 2.5 untuk Aurora PostgreSQL 12.16
<a name="auroraqpm-version12-1216"></a>

Perbaikan `apg_plan_mgmt` ekstensi di versi 2.5 untuk Aurora PostgreSQL 12.16 meliputi:

**Fitur baru**
+ Untuk menangkap rencana kueri dari Replicas, Anda harus memperbarui ekstensi `apg_plan_mgmt` dengan memanggil ALTER EXTENSION apg\_plan\_mgmt UPDATE. 
+ Anda perlu menentukan `apg_plan_mgmt.plan_capture_threshold` agar tidak mengizinkan QPM untuk menangkap rencana kueri apa pun.

## Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.3
<a name="auroraqpm-version.23"></a>

Perbaikan pada ekstensi `apg_plan_mgmt` dalam versi 2.3 meliputi hal-hal berikut:

**Fitur-fitur ekstensi baru**
+ Dukungan untuk sebuah fungsi baru, fungsi `apg_plan_mgmt.copy_outline`. Fungsi ini memungkinkan Anda menyalin hash rencana dan garis besar rencana dari satu hash SQL dan rencana hash ke yang lain. Gunakan fungsi ini apabila Anda ingin menyalin rencana yang menggunakan petunjuk ke pernyataan serupa yang lain tanpa menggunakan pernyataan petunjuk sebaris (in-line) pada setiap kejadian. Jika pembaruan pada kueri menghasilkan rencana yang tidak valid, fungsi memunculkan kesalahan dan membalik pembaruan. Lihat informasi yang lebih lengkap di [Rujukan fungsi untuk pengelolaan rencana kueri Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Functions.html#AuroraPostgreSQL.Optimize.Functions.copy_outline) dalam *Panduan Pengguna Amazon Aurora*. 

**Perbaikan ekstensi**
+ Fitur manajemen rencana kueri sekarang menyimpan paket untuk kueri yang ada di dalam prosedur dan DO-blocks. Untuk versi-versi `apg_plan_mgmt` sebelum versi 2.3, hal ini merupakan suatu keterbatasan.

Untuk mempelajari cara menginstal, memutakhirkan, dan menggunakan ekstensi `apg_plan_mgmt`, lihat [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*.

## Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.1
<a name="auroraqpm-version.21"></a>

Perbaikan pada ekstensi `apg_plan_mgmt` dalam versi 2.1 untuk Aurora PostgreSQL 11.20 meliputi hal-hal berikut:

**Fitur-fitur ekstensi baru di Aurora PostgreSQL 11.20**
+ Memperkenalkan GUC baru apg\_plan\_mgmt.log\_plan\_enforcement\_result. Bergantung pada nilainya (default: none (tidak ada)), hasil penegakan rencana ditulis ke file log Postgres.

**Perbaikan ekstensi di Aurora PostgreSQL 11.20**
+ Memperbaiki masalah dengan penegakan rencana pernyataan yang disiapkan JDBC.

Untuk mempelajari cara menginstal, memutakhirkan, dan menggunakan ekstensi `apg_plan_mgmt`, lihat [Mengelola rencana eksekusi kueri untuk Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) dalam *Panduan Pengguna Amazon Aurora*.

## Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 2.0
<a name="auroraqpm-version.20"></a>

Perubahan-perubahan ekstensi `apg_plan_mgmt` untuk versi 2.0 meliputi hal-hal berikut:

**Fitur-fitur ekstensi baru**

1. Anda kini dapat mengelola semua kueri di dalam fungsi-fungsi SQL, entah memiliki parameter ataupun tidak.

1. Anda sekarang dapat mengelola semua kueri di dalam PL/pgSQL fungsi, apakah mereka memiliki parameter atau tidak.

1. Anda kini dapat mengelola kueri dalam rencana generik, entah memiliki parameter ataupun tidak. Untuk mempelajari lebih lanjut rencana generik versus rencana kustom, lihat pernyataan `PREPARE` dalam [dokumentasi PostgreSQL](https://www.postgresql.org/docs/current/sql-prepare.html). 

1. Anda kini dapat menggunakan pengelolaan rencana kueri untuk menerapkan penggunaan tipe tertentu metode agregat dalam rencana kueri.

**Perbaikan ekstensi**

1. Anda kini dapat menyimpan rencana dengan ukuran hingga 8 KB kali setelan parameter `max_worker_processes`. Sebelumnya, ukuran rencana maksimum adalah 8 KB.

1. Memperbaiki bug untuk pernyataan yang disiapkan tanpa nama seperti pernyataan dari JDBC.

1. Sebelumnya, ketika Anda mencoba melakukan `CREATE EXTENSION apg_plan_mgmt` saat tidak dimuatkan ke `shared_preload_libraries`, koneksi sisi belakang (backend) PostgreSQL akan terputus. Kini, pesan kesalahan tercetak dan koneksi tidak terputus.

1. Nilai default `cardinality_error` di `apg_plan_mgmt.plans table` adalah NULL, tetapi dapat diatur ke -1 selama fungsi `apg_plan_mgmt.evolve_plan_baselines`. NULL kini digunakan dengan konsisten.

1. Kini, rencana disimpan untuk kueri-kueri yang merujuk ke tabel sementara.

1. Jumlah rencana maksimum default ditambah dari 1000 menjadi 10000.

1. Parameter-parameter pgss berikut tidak digunakan lagi karena mode penangkapan rencana otomatis semestinya digunakan alih-alih semua parameter itu.
   + `apg_plan_mgmt.pgss_min_calls`
   + `apg_plan_mgmt.pgss_min_mean_time_ms`
   + `apg_plan_mgmt.pgss_min_stddev_time_ms`
   + `apg_plan_mgmt.pgss_min_total_time_ms`

## Ekstensi apg\_plan\_mgmt Aurora PostgreSQL versi 1.0.1
<a name="auroraqpm-version.101"></a>

Perubahan-perubahan ekstensi `apg_plan_mgmt` untuk versi 1.0.1 meliputi hal-hal berikut:

**Fitur-fitur ekstensi baru**

1. Fungsi `validate_plans` memiliki nilai `action` baru yang disebut dengan `update_plan_hash`. Tindakan ini memperbarui ID `plan_hash` untuk rencana-rencana yang tidak dapat direproduksi dengan persis. Nilai `update_plan_hash` juga memungkinkan Anda memperbaiki suatu rencana dengan menulis ulang SQL. Anda lalu dapat mendaftarkan rencana yang bagus sebagai rencana `Approved` untuk SQL aslinya. Berikut adalah sebuah contoh penggunaan tindakan `update_plan_hash`.

   ```
   UPDATE apg_plan_mgmt.plans SET plan_hash = {{new _plan_hash}}, plan_outline = {{good_plan_outline}}
      WHERE sql_hash = {{bad_plan_sql_hash}} AND plan_hash = {{bad_plan_plan_hash}};
   SELECT apg_plan_mgmt.validate_plans({{bad_plan_sql_hash}}, {{bad_plan_plan_hash}}, 'update_plan_hash');
   SELECT apg_plan_mgmt.reload();
   ```

1. Fungsi `get_explain_stmt` baru tersedia yang menghasilkan teks pernyataan `EXPLAIN` untuk pernyataan SQL yang ditentukan. Ini meliputi parameter-parameter `sql_hash`, `plan_hash`, dan `explain_options`. 

   Parameter `explain_options` dapat berupa daftar berpemisah koma dari opsi-opsi `EXPLAIN` yang valid, seperti ditunjukkan di bawah.

   ```
   analyze,verbose,buffers,hashes,format json
   ```

   Jika parameter `explain_options` adalah NULL atau string kosong, fungsi `get_explain_stmt` menghasilkan pernyataan `EXPLAIN` sederhana. 

   Untuk membuat skrip `EXPLAIN` bagi seluruh atau sebagian beban kerja Anda, gunakan opsi `\a`, `\t`, dan `\o` untuk mengarahkan keluaran ke file. Misalnya, Anda dapat membuat skrip `EXPLAIN` untuk pernyataan peringkat teratas (K teratas) dengan menggunakan tampilan `pg_stat_statements` PostgreSQL yang diurutkan berdasarkan `total_time` dalam urutan `DESC`.

1. Lokasi persis operator kueri paralel Gather ditentukan oleh biaya, dan dapat berubah sedikit seiring dengan waktu. Untuk mencegah perbedaan ini dari menyebabkan tidak valid seluruh rencana, pengelolaan rencana kueri kini menghitung `plan_hash` yang sama walaupun operator Gather pindah ke tempat lain di dalam pohon rencana.

1. Support ditambahkan untuk pernyataan nonparameterized di dalam fungsi. pl/pgsql

1. Waktu persiapan (overhead) berkurang apabila ekstensi `apg_plan_mgmt` diinstal pada beberapa basis data dalam klaster yang sama selagi dua basis data atau lebih sedang diakses serentak. Selain itu, rilis ini memperbaiki bug di area ini yang menyebabkan rencana tidak disimpan di memori bersama.

**Perbaikan ekstensi**

1. Perbaikan pada fungsi `evolve_plan_baselines`.

   1. Fungsi `evolve_plan_baselines` kini menghitung metrik `cardinality_error` atas semua simpul di dalam rencana. Dengan menggunakan metrik ini, Anda dapat mengidentifikasi rencana apa pun di mana kesalahan estimasi kardinalitas besar, dan kualitas rencana lebih diragukan. Long-running pernyataan dengan `cardinality_error` nilai tinggi adalah kandidat prioritas tinggi untuk penyetelan kueri.

   1. Laporan yang dihasilkan oleh `evolve_plan_baselines` kini mencakup `sql_hash`, `plan_hash`, dan `status` rencana.

   1. Anda kini dapat mengizinkan `evolve_plan_baselines` untuk menyetujui rencana yang tadinya `Rejected`.

   1. Arti `speedup_factor` untuk `evolve_plan_baselines` kini selalu relatif terhadap rencana dasar. Misalnya, nilai 1.1 kini berarti 10 persen lebih cepat dari rencana awal. Nilai 0.9 berarti 10 persen lebih lambat daripada rencana awal. Perbandingan dilakukan dengan menggunakan hanya waktu berjalan, bukan waktu total.

   1. Fungsi `evolve_plan_baselines` kini menghangatkan cache dengan cara baru. Ini dilakukan dengan menjalankan rencana dasar, lalu menjalankan rencana dasar sekali lagi, dan kemudian menjalankan rencana kandidat sekali. Dahulu, `evolve_plan_baselines` menjalankan rencana kandidat dua kali. Pendekatan ini menambah waktu berjalan secara signifikan, terutama untuk rencana kandidat yang lambat. Namun, menjalankan rencana kandidat dua kali lebih dapat diandalkan apabila rencana itu menggunakan indeks yang tidak digunakan dalam rencana dasar.

1. Pengelolaan rencana kueri tidak lagi menyimpan rencana yang merujuk ke tabel atau tampilan sistem, tabel sementara, atau tabel pengelolaan rencana kueri itu sendiri.

1. Perbaikan bug yang meliputi menyimpan rencana dengan segera di cache ketika disimpan dan memperbaiki bug yang menyebabkan proses sisi belakang (backend) dihentikan.