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

# Referensi parameter untuk manajemen rencana kueri Aurora PostgreSQL
<a name="AuroraPostgreSQL.Optimize.Parameters"></a>

Anda dapat mengatur preferensi Anda untuk ekstensi `apg_plan_mgmt` dengan menggunakan parameter yang tercantum di bagian ini. Hal ini tersedia dalam parameter klaster DB kustom dan grup parameter DB yang terkait dengan klaster DB Aurora PostgreSQL Anda. Parameter ini mengontrol perilaku fitur manajemen rencana kueri dan bagaimana pengaruhnya terhadap pengoptimisasi. Untuk informasi tentang pengaturan manajemen rencana kueri, lihat [Mengaktifkan manajemen rencana kueri Aurora PostgreSQL](AuroraPostgreSQL.Optimize.overview.md#AuroraPostgreSQL.Optimize.Enable). Perubahan pada parameter berikut tidak berpengaruh jika ekstensi `apg_plan_mgmt` tidak diatur seperti yang dijelaskan dalam bagian tersebut. Untuk informasi tentang memodifikasi parameter, lihat [Memodifikasi parameter dalam grup parameter cluster DB di Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md) dan [Grup parameter DB untuk instans Amazon Aurora DB](USER_WorkingWithDBInstanceParamGroups.md). 

**Topics**
+ [apg\_plan\_mgmt.capture\_plan\_baselines](#AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines)
+ [apg\_plan\_mgmt.plan\_capture\_threshold](#AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold)
+ [apg\_plan\_mgmt.explain\_hashes](#AuroraPostgreSQL.Optimize.Parameters.explain_hashes)
+ [apg\_plan\_mgmt.log\_plan\_enforcement\_result](#AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result)
+ [apg\_plan\_mgmt.max\_databases](#AuroraPostgreSQL.Optimize.Parameters.max_databases)
+ [apg\_plan\_mgmt.max\_plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans)
+ [apg\_plan\_mgmt.plan\_hash\_version](#AuroraPostgreSQL.Optimize.Parameters.plan_hash_version)
+ [apg\_plan\_mgmt.plan\_retention\_period](#AuroraPostgreSQL.Optimize.Parameters.plan_retention_period)
+ [apg\_plan\_mgmt.unapproved\_plan\_execution\_threshold](#AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold)
+ [apg\_plan\_mgmt.use\_plan\_baselines](#AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines)
+ [auto\_explain.hashes](#AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes)

## apg\_plan\_mgmt.capture\_plan\_baselines
<a name="AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines"></a>

Mengambil rencana eksekusi kueri yang dihasilkan oleh pengoptimisasi untuk setiap pernyataan SQL dan menyimpannya dalam tampilan `dba_plans`. Secara default, jumlah maksimum rencana yang dapat disimpan adalah 10.000 seperti yang ditentukan oleh parameter `apg_plan_mgmt.max_plans`. Untuk informasi referensi, lihat [apg\_plan\_mgmt.max\_plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans).

Anda dapat mengatur parameter ini dalam grup parameter klaster DB kustom atau dalam grup parameter DB kustom. Mengubah nilai parameter ini tidak memerlukan boot ulang. 



- **off**
  - **Nilai yang diizinkan:** automatic / **Deskripsi:** Terapkan pengaturan ini baik di tingkat sesi atau dalam kelompok parameter untuk menangkap rencana yang digunakan dua kali atau lebih.
  - **Nilai yang diizinkan:** manual / **Deskripsi:** Terapkan pengaturan ini di tingkat sesi atau dalam grup parameter untuk menangkap rencana yang digunakan satu kali atau beberapa kali.
  - **Nilai yang diizinkan:** off / **Deskripsi:** Menonaktifkan pengambilan rencana.



Untuk informasi selengkapnya, lihat [Mengambil rencana eksekusi Aurora PostgreSQL](AuroraPostgreSQL.Optimize.CapturePlans.md). 

## apg\_plan\_mgmt.plan\_capture\_threshold
<a name="AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold"></a>

Menentukan ambang batas sehingga jika total biaya rencana eksekusi kueri di bawah ambang batas, rencana tidak akan diambil dalam tampilan `apg_plan_mgmt.dba_plans`. 

Mengubah nilai parameter ini tidak memerlukan boot ulang.


| Default | Nilai yang diizinkan | Deskripsi | 
| --- | --- | --- | 
| 0 | 0 - 1.79769e\+308 | Menetapkan ambang batas total biaya eksekusi rencana kueri `apg_plan_mgmt` untuk mengambil rencana.  | 

Untuk informasi selengkapnya, lihat [Memeriksa rencana kueri Aurora PostgreSQL dalam tampilan dba\_plans](AuroraPostgreSQL.Optimize.ViewPlans.md).

## apg\_plan\_mgmt.explain\_hashes
<a name="AuroraPostgreSQL.Optimize.Parameters.explain_hashes"></a>

Menentukan apakah `EXPLAIN [ANALYZE]` menunjukkan `sql_hash` dan `plan_hash` pada akhir output-nya. Mengubah nilai parameter ini tidak memerlukan boot ulang. 



- **0**
  - **Nilai yang diizinkan:** 0 (aktif) / **Deskripsi:** EXPLORE tidak menampilkan sql\_hash dan plan\_hash tanpa opsi hashes true.
  - **Nilai yang diizinkan:** 1 (nonaktif) / **Deskripsi:** EXPLORE menampilkan sql\_hash dan plan\_hash tanpa opsi hashes true.



## apg\_plan\_mgmt.log\_plan\_enforcement\_result
<a name="AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result"></a>

Menentukan apakah hasil harus dicatat untuk melihat apakah rencana yang dikelola QPM digunakan dengan benar. Ketika rencana generik yang disimpan digunakan, tidak akan ada catatan yang ditulis dalam file log. Mengubah nilai parameter ini tidak memerlukan boot ulang. 



- **none**
  - **Nilai yang diizinkan:** none  / **Deskripsi:** Tidak menunjukkan hasil pemberlakuan rencana apa pun dalam file log.
  - **Nilai yang diizinkan:** on\_error / **Deskripsi:** Hanya menampilkan hasil pemberlakuan rencana dalam file log ketika QPM gagal menggunakan rencana terkelola.
  - **Nilai yang diizinkan:** all / **Deskripsi:** Menampilkan semua hasil pemberlakuan rencana dalam file log termasuk keberhasilan dan kegagalan.



## apg\_plan\_mgmt.max\_databases
<a name="AuroraPostgreSQL.Optimize.Parameters.max_databases"></a>

Menentukan jumlah maksimum basis data pada instans Penulis klaster DB Aurora PostgreSQL Anda yang dapat menggunakan manajemen rencana kueri. Secara default, hingga 10 basis data dapat menggunakan manajemen rencana kueri. Jika Anda memiliki lebih dari 10 basis data pada instans, Anda dapat mengubah nilai pengaturan ini. Untuk mengetahui jumlah basis data pada instans tertentu, hubungkan ke instans menggunakan `psql`. Kemudian, gunakan metacommand psql, `\l`, untuk menampilkan daftar basis data.

Mengubah nilai parameter ini akan mengharuskan Anda mem-boot ulang instans agar pengaturan diterapkan.


| Default | Nilai yang diizinkan | Deskripsi | 
| --- | --- | --- | 
| 10 | 10-2147483647 | Jumlah maksimum basis data yang dapat menggunakan manajemen rencana kueri pada instans. | 

Anda dapat mengatur parameter ini dalam grup parameter klaster DB kustom atau dalam grup parameter DB kustom. 

## apg\_plan\_mgmt.max\_plans
<a name="AuroraPostgreSQL.Optimize.Parameters.max_plans"></a>

Menetapkan jumlah maksimum pernyataan SQL yang dapat dipertahankan oleh manajer rencana kueri dalam tampilan `apg_plan_mgmt.dba_plans`. Sebaiknya atur parameter ini ke `10000` atau lebih tinggi untuk semua versi Aurora PostgreSQL. 

Anda dapat mengatur parameter ini dalam grup parameter klaster DB kustom atau dalam grup parameter DB kustom. Mengubah nilai parameter ini akan mengharuskan Anda mem-boot ulang instans agar pengaturan diterapkan.


| Default | Nilai yang diizinkan | Deskripsi | 
| --- | --- | --- | 
| 10000 | 10-2147483647 | Jumlah maksimum rencana yang dapat disimpan dalam tampilan `apg_plan_mgmt.dba_plans`. <br />Default untuk Aurora PostgreSQL versi 10 dan yang lebih lama adalah 1000. | 

Untuk informasi selengkapnya, lihat [Memeriksa rencana kueri Aurora PostgreSQL dalam tampilan dba\_plans](AuroraPostgreSQL.Optimize.ViewPlans.md).

## apg\_plan\_mgmt.plan\_hash\_version
<a name="AuroraPostgreSQL.Optimize.Parameters.plan_hash_version"></a>

Menentukan kasus penggunaan yang dapat dicakup oleh perhitungan plan\_hash sesuai rancangannya. Versi `apg_plan_mgmt.plan_hash_version` yang lebih tinggi mencakup semua fungsionalitas versi yang lebih rendah. Misalnya, versi 3 mencakup kasus penggunaan yang didukung oleh versi 2. 

 Perubahan pada nilai parameter ini harus diikuti dengan panggilan ke `apg_plan_mgmt.validate_plans('update_plan_hash')`. Parameter ini memperbarui nilai plan\_hash di setiap basis data dengan apg\_plan\_mgmt diinstal dan entri dalam tabel rencana. Untuk informasi selengkapnya, lihat [Memvalidasi rencana](AuroraPostgreSQL.Optimize.Deleting.md#AuroraPostgreSQL.Optimize.Maintenance.ValidatingPlans) 



- **1**
  - **Nilai yang diizinkan:** 1 / **Deskripsi:** Perhitungan plan\_hash default.
  - **Nilai yang diizinkan:** 2 / **Deskripsi:** Perhitungan plan\_hash yang dimodifikasi untuk dukungan multi-skema.
  - **Nilai yang diizinkan:** 3 / **Deskripsi:** Perhitungan plan\_hash yang dimodifikasi untuk dukungan multi-skema dan dukungan tabel yang dipartisi.
  - **Nilai yang diizinkan:** 4 / **Deskripsi:** Perhitungan plan\_hash yang dimodifikasi untuk operator paralel dan untuk mendukung simpul terwujud.



## apg\_plan\_mgmt.plan\_retention\_period
<a name="AuroraPostgreSQL.Optimize.Parameters.plan_retention_period"></a>

Menentukan jumlah hari untuk mempertahankan rencana dalam tampilan `apg_plan_mgmt.dba_plans`, dan setelah itu, rencana tersebut akan dihapus secara otomatis. Secara default, rencana dihapus ketika 32 hari telah berlalu sejak rencana tersebut terakhir digunakan (kolom `last_used` dalam tampilan `apg_plan_mgmt.dba_plans`). Anda dapat mengubah pengaturan ini ke angka apa pun, 1 dan lebih tinggi. 

Mengubah nilai parameter ini akan mengharuskan Anda mem-boot ulang instans agar pengaturan diterapkan.


| Default | Nilai yang diizinkan | Deskripsi | 
| --- | --- | --- | 
| 32 | 1-2147483647 | Jumlah hari maksimum sejak rencana terakhir digunakan sebelum dihapus.  | 

Untuk informasi selengkapnya, lihat [Memeriksa rencana kueri Aurora PostgreSQL dalam tampilan dba\_plans](AuroraPostgreSQL.Optimize.ViewPlans.md).

## apg\_plan\_mgmt.unapproved\_plan\_execution\_threshold
<a name="AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold"></a>

Menentukan ambang batas biaya yang jika tidak tercapai, rencana yang Tidak Disetujui dapat digunakan oleh pengoptimisasi. Secara default ambang batas ini adalah 0, sehingga pengoptimisasi tidak akan menjalankan rencana yang Tidak Disetujui. Jika parameter ini diatur ke ambang batas biaya yang cukup rendah seperti 100, tidak akan ada overhead pemberlakuan rencana pada rencana sederhana (trivial). Anda juga dapat mengatur parameter ini ke nilai yang sangat besar seperti 10000000 menggunakan gaya manajemen rencana reaktif. Hal ini memungkinkan pengoptimisasi menggunakan semua rencana yang dipilih tanpa overhead pemberlakuan rencana. Namun, ketika rencana buruk ditemukan, Anda dapat menandainya secara manual sebagai “ditolak” sehingga tidak akan digunakan di lain waktu.

Nilai parameter ini merepresentasikan perkiraan biaya untuk menjalankan rencana yang diberikan. Jika rencana yang Tidak Disetujui di bawah perkiraan biaya tersebut, pengoptimisasi akan menggunakannya untuk pernyataan SQL. Anda dapat melihat rencana yang diambil dan statusnya (Disetujui, Tidak Disetujui) di tampilan `dba_plans`. Untuk mempelajari selengkapnya, lihat [Memeriksa rencana kueri Aurora PostgreSQL dalam tampilan dba\_plans](AuroraPostgreSQL.Optimize.ViewPlans.md).

Mengubah nilai parameter ini tidak memerlukan boot ulang.


| Default | Nilai yang diizinkan | Deskripsi | 
| --- | --- | --- | 
| 0 | 0-2147483647 | Perkiraan biaya rencana yang jika tidak tercapai, akan membuat rencana yang Tidak Disetujui digunakan. | 

Untuk informasi selengkapnya, lihat [Menggunakan rencana terkelola Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md). 

## apg\_plan\_mgmt.use\_plan\_baselines
<a name="AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines"></a>

Menentukan bahwa pengoptimisasi harus menggunakan salah satu rencana Disetujui yang diambil dan disimpan dalam tampilan `apg_plan_mgmt.dba_plans`. Secara default, parameter ini tidak aktif (false), sehingga menyebabkan pengoptimisasi menggunakan rencana berbiaya minimum yang dihasilkannya tanpa penilaian lebih lanjut. Mengaktifkan parameter ini (mengaturnya ke true) akan memaksa pengoptimisasi untuk memilih rencana eksekusi kueri untuk pernyataan dari acuan dasar (baseline) rencananya. Untuk informasi selengkapnya, lihat [Menggunakan rencana terkelola Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md). Untuk menemukan gambar yang menguraikan proses ini, lihat [Bagaimana cara pengoptimisasi memilih rencana yang akan dijalankan](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans). 

Anda dapat mengatur parameter ini dalam grup parameter klaster DB kustom atau dalam grup parameter DB kustom. Mengubah nilai parameter ini tidak memerlukan boot ulang.



- **false**
  - **Nilai yang diizinkan:** true / **Deskripsi:** Menggunakan rencana yang Disetujui, Pilihan, atau Tidak Disetujui dari apg\_plan\_mgmt.dba\_plans. Jika tidak ada yang memenuhi semua kriteria evaluasi untuk pengoptimisasi, maka pengoptimisasi dapat menggunakan rencana berbiaya minimum yang dihasilkannya sendiri. Untuk informasi selengkapnya, lihat [Bagaimana cara pengoptimisasi memilih rencana yang akan dijalankan](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans).
  - **Nilai yang diizinkan:** false / **Deskripsi:** Menggunakan rencana berbiaya minimum yang dihasilkan oleh pengoptimisasi.



Anda dapat mengevaluasi waktu respons dari berbagai rencana yang diambil dan mengubah status rencana, sesuai kebutuhan. Untuk informasi selengkapnya, lihat [Meningkatkan rencana kueri PostgreSQL Aurora](AuroraPostgreSQL.Optimize.Maintenance.md). 

## auto\_explain.hashes
<a name="AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes"></a>

Menentukan apakah output auto\_explain menampilkan sql\_hash dan plan\_hash. Mengubah nilai parameter ini tidak memerlukan boot ulang. 



- **0 (nonaktif)**
  - **Nilai yang diizinkan:** 0 (nonaktif) / **Deskripsi:** Hasil auto\_explain tidak menunjukkan sql\_hash dan plan\_hash.
  - **Nilai yang diizinkan:** 1 (aktif) / **Deskripsi:** Hasil auto\_explain menunjukkan sql\_hash dan plan\_hash.