

 Amazon Redshift tidak akan lagi mendukung pembuatan Python UDFs baru mulai Patch 198. Python yang ada UDFs akan terus berfungsi hingga 30 Juni 2026. Untuk informasi lebih lanjut, lihat [posting blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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

# Aturan pemantauan kueri WLM
<a name="cm-c-wlm-query-monitoring-rules"></a>

Di Amazon Redshift workload management (WLM), aturan pemantauan kueri menentukan batas kinerja berbasis metrik untuk antrian WLM dan menentukan tindakan apa yang harus diambil ketika kueri melampaui batas-batas tersebut. Misalnya, untuk antrian yang didedikasikan untuk kueri berjalan pendek, Anda dapat membuat aturan yang membatalkan kueri yang berjalan selama lebih dari 60 detik. Untuk melacak kueri yang dirancang dengan buruk, Anda mungkin memiliki aturan lain yang mencatat kueri yang berisi loop bersarang. 

Anda menentukan aturan pemantauan kueri sebagai bagian dari konfigurasi manajemen beban kerja (WLM) Anda. Anda dapat menentukan hingga 25 aturan untuk setiap antrian, dengan batas 25 aturan untuk semua antrian. Setiap aturan mencakup hingga tiga kondisi, atau predikat, dan satu tindakan. *Predikat* terdiri dari metrik, kondisi perbandingan (=, <, or >), dan nilai. Jika semua predikat untuk aturan apa pun terpenuhi, tindakan aturan itu dipicu. Tindakan aturan yang mungkin adalah log, hop, dan abort, seperti yang dibahas berikut. 

Aturan dalam antrian tertentu hanya berlaku untuk kueri yang berjalan dalam antrian itu. Aturan tidak tergantung pada aturan lain. 

WLM mengevaluasi metrik setiap 10 detik. Amazon Redshift menerapkan aturan pemantauan kueri pada tingkat kueri anak saat kueri ditulis ulang secara otomatis. Jika lebih dari satu aturan dipicu selama periode yang sama, WLM memilih aturan dengan tindakan paling parah. Jika tindakan untuk dua aturan memiliki tingkat keparahan yang sama, WLM menjalankan aturan dalam urutan abjad, berdasarkan nama aturan. Jika tindakan melompat atau membatalkan, tindakan dicatat dan kueri diusir dari antrian. Jika tindakannya log, kueri terus berjalan dalam antrian. WLM hanya memulai satu tindakan log per kueri per aturan. Jika antrian berisi aturan lain, aturan tersebut tetap berlaku. Jika tindakannya hop dan kueri dirutekan ke antrian lain, aturan untuk antrian baru berlaku. Untuk informasi selengkapnya tentang pemantauan kueri dan tindakan pelacakan yang dilakukan pada kueri tertentu, lihat kumpulan sampel di[Akselerasi kueri pendek](wlm-short-query-acceleration.md).

Ketika semua predikat aturan terpenuhi, WLM menulis baris ke tabel sistem[STL\$1WLM\$1RULE\$1ACTION](r_STL_WLM_RULE_ACTION.md). Selain itu, Amazon Redshift merekam metrik kueri untuk kueri yang sedang berjalan. [STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md) Metrik untuk kueri yang diselesaikan disimpan di. [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) 

**catatan**  
Untuk Amazon Redshift Tanpa Server, Anda dapat mengonfigurasi antrian kueri dan aturan pemantauan menggunakan parameter. `wlm_json_configuration` Ini memungkinkan Anda membuat beberapa antrian dengan peran pengguna, grup kueri, dan aturan pemantauan yang berbeda. *Untuk informasi selengkapnya tentang mengonfigurasi antrian kueri tanpa server, lihat [Menyetel antrian kueri](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroup-query-queues.html) di Panduan Manajemen Pergeseran Merah Amazon.*

## Mendefinisikan aturan pemantauan kueri
<a name="cm-c-wlm-defining-query-monitoring-rules"></a>

Anda membuat aturan pemantauan kueri sebagai bagian dari konfigurasi WLM Anda, yang Anda tentukan sebagai bagian dari definisi grup parameter klaster Anda.

Anda dapat membuat aturan menggunakan Konsol Manajemen AWS atau terprogram menggunakan JSON. 

**catatan**  
Jika Anda memilih untuk membuat aturan secara terprogram, kami sangat menyarankan menggunakan konsol untuk menghasilkan JSON yang Anda sertakan dalam definisi grup parameter. Untuk informasi selengkapnya, lihat [Membuat aturan pemantauan kueri](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) dan [Mengonfigurasi Nilai Parameter Menggunakan AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html#configure-parameters-using-the-cli) Panduan Manajemen *Pergeseran Merah Amazon*. 

Untuk menentukan aturan pemantauan kueri, Anda menentukan elemen berikut:
+ Nama aturan - Nama aturan harus unik dalam konfigurasi WLM. Nama aturan dapat mencapai 32 karakter alfanumerik atau garis bawah, dan tidak dapat berisi spasi atau tanda kutip. Anda dapat memiliki hingga 25 aturan per antrian, dan batas total untuk semua antrian adalah 25 aturan.
+ Satu atau lebih predikat — Anda dapat memiliki hingga tiga predikat per aturan. Jika semua predikat untuk aturan apa pun terpenuhi, tindakan terkait dipicu. Predikat didefinisikan oleh nama metrik, operator (=, <, or >), dan nilai. Contohnya adalah `query_cpu_time > 100000`. Untuk daftar metrik dan contoh nilai untuk metrik yang berbeda, lihat [Metrik pemantauan kueri untuk Amazon Redshift disediakan](#cm-c-wlm-query-monitoring-metrics) berikut di bagian ini. 
+ Tindakan — Jika lebih dari satu aturan dipicu, WLM memilih aturan dengan tindakan paling parah. Tindakan yang mungkin, dalam urutan keparahan yang meningkat, adalah:
  + Log - Rekam informasi tentang kueri dalam tabel sistem STL\$1WLM\$1RULE\$1ACTION. Gunakan tindakan Log saat Anda hanya ingin menulis catatan log. WLM membuat paling banyak satu log per kueri, per aturan. Setelah tindakan log, aturan lain tetap berlaku dan WLM terus memantau kueri. 
  + Hop (hanya tersedia dengan WLM manual) - Log tindakan dan lompat kueri ke antrian pencocokan berikutnya. Jika tidak ada antrian lain yang cocok, kueri dibatalkan. QMR hanya [membuat pernyataan TABEL AS](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_TABLE_AS.html) (CTAS) dan kueri hanya-baca, seperti pernyataan SELECT. Untuk informasi selengkapnya, lihat [Antrian kueri WLM melompat](wlm-queue-hopping.md). 
  + Batalkan — Log tindakan dan batalkan kueri. QMR tidak menghentikan pernyataan COPY dan operasi pemeliharaan, seperti ALTER, ANALYSIS dan VACUUM. 
  + Ubah prioritas (hanya tersedia dengan WLM otomatis) - Ubah prioritas kueri. 

Untuk membatasi runtime kueri, sebaiknya buat aturan pemantauan kueri alih-alih menggunakan batas waktu WLM. Misalnya, Anda dapat mengatur `max_execution_time` ke 50.000 milidetik seperti yang ditunjukkan pada cuplikan JSON berikut.

```
"max_execution_time": 50000
```

Namun sebaiknya Anda mendefinisikan aturan pemantauan kueri yang setara. Contoh berikut menunjukkan aturan pemantauan query yang ditetapkan `query_execution_time` untuk 50 detik:

```
"rules": 
[
    {
        "rule_name": "rule_query_execution",
        "predicate": [
            {
                "metric_name": "query_execution_time",
                "operator": ">",
                "value": 50
            }
        ],
        "action": "abort"
    }            
]
```

*Untuk langkah-langkah untuk membuat atau mengubah aturan pemantauan kueri, lihat [Membuat aturan pemantauan kueri](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) dan [Properti di Parameter wlm\$1json\$1configuration di](https://docs.aws.amazon.com/redshift/latest/mgmt/workload-mgmt-config.html#wlm-json-config-properties) Panduan Manajemen Amazon Redshift.*

Anda dapat menemukan informasi selengkapnya tentang aturan pemantauan kueri dalam topik berikut: 
+  [Metrik pemantauan kueri untuk Amazon Redshift disediakan](#cm-c-wlm-query-monitoring-metrics) 
+  [Templat aturan pemantauan kueri](#cm-c-wlm-query-monitoring-templates) 
+  [Membuat aturan pemantauan kueri](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) 
+  [Mengkonfigurasi Manajemen Beban Kerja](https://docs.aws.amazon.com/redshift/latest/mgmt/workload-mgmt-config.html) 
+  [Tabel dan tampilan sistem untuk aturan pemantauan kueri](#cm-c-wlm-qmr-tables-and-views) 

## Metrik pemantauan kueri untuk Amazon Redshift disediakan
<a name="cm-c-wlm-query-monitoring-metrics"></a>

Tabel berikut menjelaskan metrik yang digunakan dalam aturan pemantauan kueri. (Metrik ini berbeda dari metrik yang disimpan dalam tabel [STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md) dan [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) sistem.) 

Untuk metrik tertentu, ambang kinerja dilacak baik pada tingkat kueri atau tingkat segmen. Untuk informasi selengkapnya tentang segmen dan langkah, lihat[Perencanaan kueri dan alur kerja eksekusi](c-query-planning.md).

**catatan**  
[Batas waktu WLM](cm-c-defining-query-queues.md#wlm-timeout)Parameter ini berbeda dari aturan pemantauan kueri.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

**catatan**  
Tindakan hop tidak didukung dengan `query_queue_time` predikat. Artinya, aturan yang didefinisikan untuk melompat ketika `query_queue_time` predikat terpenuhi diabaikan. 
Waktu eksekusi segmen yang pendek dapat mengakibatkan kesalahan pengambilan sampel dengan beberapa metrik, seperti `io_skew` dan. `query_cpu_usage_percent` Untuk menghindari atau mengurangi kesalahan pengambilan sampel, sertakan waktu eksekusi segmen dalam aturan Anda. Titik awal yang baik adalah`segment_execution_time > 10`.

[SVL\$1QUERY\$1METRICS](r_SVL_QUERY_METRICS.md)Tampilan menunjukkan metrik untuk kueri yang diselesaikan. [SVL\$1QUERY\$1METRICS\$1SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md)Tampilan menunjukkan nilai maksimum metrik untuk kueri yang diselesaikan. Gunakan nilai dalam tampilan ini sebagai bantuan untuk menentukan nilai ambang batas untuk mendefinisikan aturan pemantauan kueri.

## Metrik pemantauan kueri untuk Amazon Redshift Tanpa Server
<a name="cm-c-wlm-query-monitoring-metrics-serverless"></a>

Tabel berikut menjelaskan metrik yang digunakan dalam aturan pemantauan kueri untuk Amazon Redshift Tanpa Server. 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

**catatan**  
Tindakan hop tidak didukung dengan `max_query_queue_time` predikat. Artinya, aturan yang didefinisikan untuk melompat ketika `max_query_queue_time` predikat terpenuhi diabaikan. 
Waktu eksekusi segmen yang pendek dapat mengakibatkan kesalahan pengambilan sampel dengan beberapa metrik, seperti `max_io_skew` dan. `max_query_cpu_usage_percent`

Untuk Amazon Redshift Tanpa Server, Anda dapat mengonfigurasi antrian kueri dan aturan pemantauan menggunakan parameter. `wlm_json_configuration` Ini memungkinkan Anda membuat beberapa antrian dengan peran pengguna yang berbeda, grup kueri, dan aturan pemantauan menggunakan metrik yang tercantum di atas. *Untuk informasi selengkapnya tentang mengonfigurasi antrian kueri tanpa server, lihat [struktur konfigurasi WLM JSON di](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroup-query-queues.html#serverless-wlm-json-configuration) Panduan Manajemen Amazon Redshift.*

## Templat aturan pemantauan kueri
<a name="cm-c-wlm-query-monitoring-templates"></a>

Saat menambahkan aturan menggunakan konsol Amazon Redshift, Anda dapat memilih untuk membuat aturan dari templat yang telah ditentukan sebelumnya. Amazon Redshift membuat aturan baru dengan serangkaian predikat dan mengisi predikat dengan nilai default. Tindakan default adalah log. Anda dapat memodifikasi predikat dan tindakan untuk memenuhi kasus penggunaan Anda. 

Tabel berikut mencantumkan templat yang tersedia. 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

## Tabel dan tampilan sistem untuk aturan pemantauan kueri
<a name="cm-c-wlm-qmr-tables-and-views"></a>

Ketika semua predikat aturan terpenuhi, WLM menulis baris ke tabel sistem[STL\$1WLM\$1RULE\$1ACTION](r_STL_WLM_RULE_ACTION.md). Baris ini berisi detail untuk kueri yang memicu aturan dan tindakan yang dihasilkan. 

Selain itu, Amazon Redshift mencatat metrik kueri tabel dan tampilan sistem berikut.
+ [STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md)Tabel menampilkan metrik untuk kueri yang sedang berjalan.
+ [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md)Tabel mencatat metrik untuk kueri yang diselesaikan. 
+ [SVL\$1QUERY\$1METRICS](r_SVL_QUERY_METRICS.md)Tampilan menunjukkan metrik untuk kueri yang diselesaikan. 
+ [SVL\$1QUERY\$1METRICS\$1SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md)Tampilan menunjukkan nilai maksimum metrik untuk kueri yang diselesaikan.