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
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. 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 Mengubah parameter dalam grup parameter klaster DB dan Bekerja dengan grup parameter DB dalam instance DB.
Parameter
- apg_plan_mgmt.capture_plan_baselines
- apg_plan_mgmt.plan_capture_threshold
- apg_plan_mgmt.explain_hashes
- apg_plan_mgmt.log_plan_enforcement_result
- apg_plan_mgmt.max_databases
- apg_plan_mgmt.max_plans
- apg_plan_mgmt.plan_hash_version
- apg_plan_mgmt.plan_retention_period
- apg_plan_mgmt.unapproved_plan_execution_threshold
- apg_plan_mgmt.use_plan_baselines
- auto_explain.hashes
apg_plan_mgmt.capture_plan_baselines
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.
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.
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| off | automatic | Mengaktifkan pengambilan rencana untuk semua basis data pada instans DB. Mengumpulkan rencana untuk setiap pernyataan SQL yang berjalan dua kali atau lebih. Gunakan pengaturan ini untuk beban kerja yang besar atau berkembang untuk memberikan stabilitas rencana. |
| manual | Mengaktifkan pengambilan rencana untuk pernyataan berikutnya saja, sampai Anda menonaktifkannya lagi. Pengaturan ini memungkinkan Anda mengambil rencana eksekusi kueri untuk pernyataan SQL kritis tertentu saja atau untuk kueri bermasalah yang diketahui. | |
| off | Menonaktifkan pengambilan rencana. |
Untuk informasi selengkapnya, lihat Mengambil rencana eksekusi Aurora PostgreSQL.
apg_plan_mgmt.plan_capture_threshold
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 |
Untuk informasi selengkapnya, lihat Memeriksa rencana kueri Aurora PostgreSQL dalam tampilan dba_plans.
apg_plan_mgmt.explain_hashes
Menentukan apakah EXPLAIN [ANALYZE] menunjukkan sql_hash dan plan_hash pada akhir output-nya. Mengubah nilai parameter ini tidak memerlukan boot ulang.
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| 0 | 0 (aktif) | EXPLORE tidak menampilkan sql_hash dan plan_hash tanpa opsi hashes true. |
| 1 (nonaktif) | EXPLORE menampilkan sql_hash dan plan_hash tanpa opsi hashes true. |
apg_plan_mgmt.log_plan_enforcement_result
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.
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| none | none | Tidak menunjukkan hasil pemberlakuan rencana apa pun dalam file log. |
| on_error | Hanya menampilkan hasil pemberlakuan rencana dalam file log ketika QPM gagal menggunakan rencana terkelola. | |
| all | Menampilkan semua hasil pemberlakuan rencana dalam file log termasuk keberhasilan dan kegagalan. |
apg_plan_mgmt.max_databases
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
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 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.
apg_plan_mgmt.plan_hash_version
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
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| 1 | 1 | Perhitungan plan_hash default. |
| 2 | Perhitungan plan_hash yang dimodifikasi untuk dukungan multi-skema. | |
| 3 | Perhitungan plan_hash yang dimodifikasi untuk dukungan multi-skema dan dukungan tabel yang dipartisi. | |
| 4 | Perhitungan plan_hash yang dimodifikasi untuk operator paralel dan untuk mendukung simpul terwujud. |
apg_plan_mgmt.plan_retention_period
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.
apg_plan_mgmt.unapproved_plan_execution_threshold
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.
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.
apg_plan_mgmt.use_plan_baselines
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. Untuk menemukan gambar yang menguraikan proses ini, lihat Bagaimana cara pengoptimisasi memilih rencana yang akan dijalankan.
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.
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| false | true | 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. |
| false | 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 Mengelola rencana eksekusi Aurora PostgreSQL.
auto_explain.hashes
Menentukan apakah output auto_explain menampilkan sql_hash dan plan_hash. Mengubah nilai parameter ini tidak memerlukan boot ulang.
| Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|
| 0 (nonaktif) | 0 (nonaktif) | Hasil auto_explain tidak menunjukkan sql_hash dan plan_hash. |
| 1 (aktif) | Hasil auto_explain menunjukkan sql_hash dan plan_hash. |
