

 Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, 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/) yang diterbitkan pada 30 Juni 2025. 

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

# Manajemen beban kerja
<a name="workload-mgmt-config"></a>

Di Amazon Redshift, Anda menggunakan manajemen beban kerja (WLM) untuk menentukan jumlah antrian kueri yang tersedia, dan bagaimana kueri dialihkan ke antrian tersebut untuk diproses. WLM adalah bagian dari konfigurasi grup parameter. Cluster menggunakan konfigurasi WLM yang ditentukan dalam grup parameter terkait. 

Saat Anda membuat grup parameter, konfigurasi WLM default berisi satu antrian yang dapat menjalankan hingga lima kueri secara bersamaan. Anda dapat menambahkan antrian tambahan dan mengkonfigurasi properti WLM di masing-masing properti jika Anda ingin lebih banyak kontrol atas pemrosesan kueri. Setiap antrian yang Anda tambahkan memiliki konfigurasi WLM default yang sama sampai Anda mengkonfigurasi propertinya.

Saat Anda menambahkan antrian tambahan, antrian terakhir dalam konfigurasi adalah antri * an * default. Kecuali kueri dirutekan ke antrian lain berdasarkan kriteria dalam konfigurasi WLM, kueri tersebut diproses oleh antrian default. Anda dapat menentukan mode dan tingkat konkurensi (slot kueri) untuk antrian default, tetapi Anda tidak dapat menentukan grup pengguna atau grup kueri untuk antrian default.

 Seperti parameter lainnya, Anda tidak dapat memodifikasi konfigurasi WLM di grup parameter default. Cluster yang terkait dengan grup parameter default selalu menggunakan konfigurasi WLM default. Untuk memodifikasi konfigurasi WLM, buat grup parameter baru dan kemudian kaitkan grup parameter tersebut dengan cluster apa pun yang memerlukan konfigurasi WLM kustom Anda. 

## Sifat dinamis dan statis WLM
<a name="wlm-dynamic-and-static-properties"></a>

Properti konfigurasi WLM bersifat dinamis atau statis. Anda dapat menerapkan properti dinamis ke database tanpa reboot cluster, tetapi properti statis memerlukan reboot cluster agar perubahan diterapkan. Untuk informasi selengkapnya tentang properti statis dan dinamis, lihat properti [ konfigurasi dinamis dan statis ](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-dynamic-properties.html) WLM.

## Properti untuk parameter konfigurasi WLM
<a name="wlm-json-config-properties"></a>

Anda dapat mengonfigurasi WLM dengan menggunakan konsol Amazon Redshift AWS CLI, Amazon Redshift API, atau salah satu SDK. AWS Konfigurasi WLM menggunakan beberapa properti untuk menentukan perilaku antrian, seperti alokasi memori di seluruh antrian, jumlah kueri yang dapat dijalankan secara bersamaan dalam antrian, dan sebagainya.

**catatan**  
 Properti berikut muncul dengan nama konsol Amazon Redshift mereka, dengan nama properti JSON yang sesuai dalam deskripsi. 

Tabel berikut merangkum apakah properti berlaku untuk WLM otomatis atau WLM manual.


****  

| Properti WLM | WLM otomatis | WLM manual | 
| --- | --- | --- | 
| WLM otomatis | Ya | Ya | 
| Aktifkan akselerasi kueri singkat | Ya | Ya | 
| Waktu berjalan maksimum untuk kueri pendek | Ya | Ya | 
| Prioritas | Ya | Tidak | 
| Jenis antrian | Ya | Ya | 
| Nama antrian | Ya | Ya | 
| Mode penskalaan konkurensi | Ya | Ya | 
| Bersamaan | Tidak | Ya | 
| Grup pengguna | Ya | Ya | 
| Wildcard grup pengguna | Ya | Ya | 
| Grup kueri | Ya | Ya | 
| Karakter pengganti grup kueri | Ya | Ya | 
| Peran pengguna | Ya | Ya | 
| Karakter pengganti peran pengguna | Ya | Ya | 
| Waktu habis | Tidak | Usang | 
| Memori | Tidak | Ya | 
| Aturan Pemantauan Kueri | Ya | Ya | 

Daftar berikut menjelaskan properti WLM yang dapat Anda konfigurasi.

**WLM Otomatis **  
**Auto WLM ** diatur untuk mengaktifkan W `true` LM otomatis. WLM otomatis menetapkan nilai untuk Konkur ** ensi pada main ** dan ** Memori (%) ** ke. `Auto` Amazon Redshift mengelola konkurensi kueri dan alokasi memori. Nilai default-nya `true`.  
Properti JSON: `auto_wlm`

**Aktifkan akselerasi kueri singkat **  
Akselerasi kueri pendek (SQA) memprioritaskan kueri berjalan pendek yang dipilih di depan kueri yang berjalan lebih lama. SQA mengeksekusi kueri yang berjalan singkat di ruang khusus, sehingga kueri SQA tidak dipaksa menunggu dalam antrian di belakang kueri yang lebih lama. Dengan SQA, kueri yang berjalan pendek mulai dieksekusi lebih cepat dan pengguna melihat hasilnya lebih cepat. Saat Anda mengaktifkan SQA, Anda juga dapat menentukan waktu berjalan maksimum untuk kueri pendek. Untuk mengaktifkan SQA, tent `true` ukan. Nilai default-nya `false`. Pengaturan ini diterapkan untuk setiap grup parameter daripada antrian.  
Properti JSON: `short_query_queue`

****Waktu berjalan maksimum untuk kueri pendek ** **  
Ketika Anda mengaktifkan SQA, Anda dapat menentukan 0 untuk membiarkan WLM secara dinamis mengatur waktu berjalan maksimum untuk kueri pendek. Atau, Anda dapat menentukan nilai 1—20 detik, dalam milidetik. Nilai default-nya adalah `0`.  
Properti JSON: `max_execution_time`

**Prioritas**  
Prioritas menetapkan prioritas query yang berjalan dalam antrian. Untuk mengatur prioritas, mode ** WLM ** harus diatur ke ** Auto WLM**; yaitu, `auto_wlm` harus. `true` Nilai prioritas dapat berupa`highest`,`high`,`normal`,`low`, dan`lowest`. Nilai default-nya `normal`.  
Properti JSON: `priority`

**Jenis antrian **  
Jenis antrian menunjuk antrian seperti yang digunakan oleh ** Auto WLM ** atau ** Manual WLM. ** Setel `queue_type` ke salah `auto` satu atau`manual`. Jika tidak ditentukan, default-nya adalah `manual`.  
Properti JSON: `queue_type`

**Nama antrian **  
Nama antrean. Anda dapat mengatur nama antrian berdasarkan kebutuhan bisnis Anda. Nama antrian harus unik dalam konfigurasi WLM, maksimal 64 karakter alfanumerik, garis bawah atau spasi, dan tidak dapat berisi tanda kutip. Misalnya, jika Anda memiliki antrian untuk kueri ETL Anda, Anda dapat menamainya`ETL queue`. Nama ini digunakan dalam metrik, nilai tabel sistem, dan konsol Amazon Redshift untuk mengidentifikasi antrian. Kueri dan laporan yang menggunakan nama dari sumber-sumber ini harus dapat menangani perubahan nama. Sebelumnya, nama antrian dibuat oleh Amazon Redshift. Nama default antrian adalah`Queue 1`,`Queue 2`, hingga antrian terakhir bernama`Default queue`.   
Jika Anda mengubah nama antrian, nilai `QueueName` dimensi metrik antrian WLM (seperti,, WLMQueueLength, WLMQueueWaitTime, WLMQueriesCompletedPerSecond, WLMQueryDuration WLMRunningQueries, dan seterusnya) juga berubah. Jadi, jika Anda mengubah nama antrian, Anda mungkin perlu mengubah CloudWatch alarm yang telah Anda atur. 
Properti JSON: `name`

**Mode penskalaan konkurensi **  
Untuk mengaktifkan penskalaan konkurensi pada antrian, setel mode ** Penskalaan ** Konkurensi ke. `auto` Ketika jumlah kueri yang dialihkan ke antrian melebihi konkurensi yang dikonfigurasi antrian, kueri yang memenuhi syarat akan masuk ke cluster penskalaan. Ketika slot tersedia, kueri berjalan di cluster utama. Nilai default-nya `off`.  
Properti JSON: `concurrency_scaling`

**Konkurensi **  
Jumlah query yang dapat berjalan secara bersamaan dalam antrian WLM manual. Properti ini hanya berlaku untuk WLM manual. Jika penskalaan konkurensi diaktifkan, kueri yang memenuhi syarat akan masuk ke cluster penskalaan saat antrian mencapai tingkat konkurensi (slot kueri). Jika penskalaan konkurensi tidak diaktifkan, kueri menunggu dalam antrian sampai slot tersedia. Kisarannya antara 1 dan 50.  
Properti JSON: `query_concurrency`

**Grup Pengguna **  
Daftar nama grup pengguna yang dipisahkan koma. Ketika anggota grup pengguna menjalankan kueri dalam database, kueri mereka dialihkan ke antrian yang terkait dengan grup pengguna mereka.  
Properti JSON: `user_group`

**Wildcard Grup Pengguna **  
Nilai Boolean yang menunjukkan apakah akan mengaktifkan wildcard untuk grup pengguna. Jika ini 0, wildcard dinonaktifkan; jika ini adalah 1, wildcard diaktifkan. Ketika wildcard diaktifkan, Anda dapat menggunakan “\*” atau “?” untuk menentukan beberapa grup pengguna saat menjalankan kueri. Untuk informasi selengkapnya, lihat [ Wildcard](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Properti JSON: `user_group_wild_card`

**Grup Kueri **  
Daftar grup kueri yang dipisahkan koma. Ketika anggota grup kueri menjalankan kueri dalam database, kueri mereka dialihkan ke antrian yang terkait dengan grup kueri mereka.  
Properti JSON: `query_group`

**Wildcard Grup Kueri **  
Nilai Boolean yang menunjukkan apakah akan mengaktifkan wildcard untuk grup kueri. Jika ini 0, wildcard dinonaktifkan; jika ini adalah 1, wildcard diaktifkan. Ketika wildcard diaktifkan, Anda dapat menggunakan “\*” atau “?” untuk menentukan beberapa grup kueri saat menjalankan kueri. Untuk informasi selengkapnya, lihat [ Wildcard](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Properti JSON: `query_group_wild_card`

**Peran Pengguna **  
Daftar peran pengguna yang dipisahkan koma. Ketika anggota dengan peran pengguna tersebut menjalankan kueri dalam database, kueri mereka dialihkan ke antrian yang terkait dengan peran pengguna mereka. Untuk informasi selengkapnya tentang peran pengguna, lihat kontrol [ Role-based akses (RBAC)](https://docs.aws.amazon.com/redshift/latest/dg/t_Roles.html).  
Properti JSON: `user_role`

**Wildcard Peran Pengguna **  
Nilai Boolean yang menunjukkan apakah akan mengaktifkan wildcard untuk grup kueri. Jika ini 0, wildcard dinonaktifkan; jika ini adalah 1, wildcard diaktifkan. Ketika wildcard diaktifkan, Anda dapat menggunakan “\*” atau “?” untuk menentukan beberapa grup kueri saat menjalankan kueri. Untuk informasi selengkapnya, lihat [ Wildcard](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Properti JSON: `user_role_wild_card`

**Waktu habis (ms) **  
WLM timeout (`max_execution_time`) tidak digunakan lagi. Ini tidak tersedia saat menggunakan WLM otomatis. Sebagai gantinya, buat aturan pemantauan kueri (QMR) menggunakan `query_execution_time` untuk membatasi waktu eksekusi yang telah berlalu untuk kueri. Untuk informasi selengkapnya, lihat aturan [ pemantauan kueri ](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html) WLM.   
Waktu maksimum, dalam milidetik, kueri dapat dijalankan sebelum dibatalkan. Dalam beberapa kasus, kueri read-only, seperti pernyataan SELECT, mungkin dibatalkan karena batas waktu WLM. Dalam kasus ini, WLM mencoba merutekan kueri ke antrian pencocokan berikutnya berdasarkan aturan penetapan antrian WLM. Jika kueri tidak cocok dengan definisi antrian lainnya, kueri dibatalkan; kueri tidak ditetapkan ke antrian default. Untuk informasi selengkapnya, lihat lompatan antrian kueri [ WLM. ](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-queue-hopping) Waktu tunggu WLM tidak berlaku untuk kueri yang telah mencapai status. `returning` Untuk melihat status query, lihat tabel sistem [ STV\_WLM\_QUERY\_STATE](https://docs.aws.amazon.com/redshift/latest/dg/r_STV_WLM_QUERY_STATE.html).  
Properti JSON: `max_execution_time`

**Memori (%) **  
Persentase memori yang dialokasikan ke antrian. Jika Anda menentukan persentase memori untuk setidaknya satu antrian, Anda harus menentukan persentase untuk semua antrian lainnya, hingga total 100 persen. Jika alokasi memori Anda di bawah 100 persen di semua antrian, memori yang tidak terisi dikelola oleh layanan. Layanan dapat memberikan sementara memori yang tidak terisi ini ke antrian yang meminta memori tambahan untuk diproses.  
Properti JSON: `memory_percent_to_use`

**Aturan Pemantauan Kueri **  
Anda dapat menggunakan aturan pemantauan kueri WLM untuk terus memantau antrian WLM Anda untuk kueri berdasarkan kriteria, atau predikat, yang Anda tentukan. Misalnya, Anda dapat memantau kueri yang cenderung menghabiskan sumber daya sistem yang berlebihan, dan kemudian memulai tindakan tertentu ketika kueri melebihi batas kinerja yang Anda tentukan.   
Jika Anda memilih untuk membuat aturan secara terprogram, kami sangat menyarankan menggunakan konsol untuk menghasilkan JSON yang Anda sertakan dalam definisi grup parameter.
Anda mengaitkan aturan pemantauan kueri dengan antrian kueri tertentu. Anda dapat memiliki hingga 25 aturan per antrian, dan batas total untuk semua antrian adalah 25 aturan.  
Properti JSON: `rules`  
Hierarki properti JSON:   

```
rules
    rule_name
    predicate
        metric_name
        operator
        value
    action
        value
```
Untuk setiap aturan, Anda menentukan properti berikut:  
+ `rule_name`— Nama aturan harus unik dalam konfigurasi WLM. Nama aturan dapat terdiri dari hingga 32 karakter alfanumerik atau garis bawah, dan tidak dapat berisi spasi atau tanda kutip.
  + `predicate`— Anda dapat memiliki hingga tiga predikat per aturan. Untuk setiap predikat, tentukan properti berikut.
    + `metric_name`— Untuk daftar metrik, lihat Metrik pem [ antauan kueri ](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html#cm-c-wlm-query-monitoring-metrics) di Panduan * Pengembang Database * Amazon Redshift.
    + `operator`— Operasi adalah`=`,`<`, dan`>`. 
    + `value`— Nilai ambang untuk metrik yang ditentukan yang memicu tindakan. 
+ `action`Setiap aturan dikaitkan dengan satu tindakan. Tindakan yang valid adalah:
  + `log`
  + `hop`(hanya tersedia dengan WLM manual)
  + `abort`
  + `change_query_priority`(hanya tersedia dengan WLM otomatis)
Contoh berikut menunjukkan JSON untuk aturan pemantauan kueri WLM bernama`rule_1`, dengan dua predikat dan tindakan. `hop`   

```
"rules": [
          {
            "rule_name": "rule_1",
            "predicate": [
              {
                "metric_name": "query_execution_time",
                "operator": ">",
                "value": 100000
              },
              {
                "metric_name": "query_blocks_read",
                "operator": ">",
                "value": 1000
              }
            ],
            "action": "hop"
          }
        ]
```

Untuk informasi selengkapnya tentang masing-masing properti dan strategi untuk mengonfigurasi antrian kueri, lihat Mener [ apkan manajemen beban kerja ](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-implementing-workload-management.html) di Panduan Pengembang Database * Amazon Redshift. * 

## Mengkonfigurasi parameter WLM menggunakan AWS CLI
<a name="Configuring-the-wlm-json-configuration-Parameter"></a>

 Untuk mengkonfigurasi WLM, Anda memodifikasi `wlm_json_configuration` parameter. Ukuran maksimum nilai `wlm_json_configuration` properti adalah 8000 karakter. Nilai diformat dalam JavaScript Object Notation (JSON). Jika Anda mengonfigurasi WLM dengan menggunakan AWS CLI, Amazon Redshift API, atau salah satu AWS SDK, gunakan sisa bagian ini untuk mempelajari cara membuat struktur JSON untuk parameter. `wlm_json_configuration` 

**catatan**  
 Jika Anda mengonfigurasi WLM menggunakan konsol Amazon Redshift, Anda tidak perlu memahami pemformatan JSON karena konsol menyediakan cara mudah untuk menambahkan antrian dan mengonfigurasi propertinya. Untuk informasi selengkapnya tentang mengkonfigurasi WLM dengan menggunakan konsol, lihat[Mengubah grup parameter](parameter-group-modify.md). 

Contoh

Contoh berikut adalah konfigurasi WLM default, yang mendefinisikan satu antrian dengan WLM otomatis. 

```
{
   "auto_wlm": true
}
```

Contoh

Contoh berikut adalah konfigurasi WLM kustom, yang mendefinisikan satu antrian WLM manual dengan tingkat konkurensi (slot kueri) lima. 

```
{
   "query_concurrency":5
}
```

Sintaksis

Konfigurasi WLM default sangat sederhana, dengan hanya antrian dan satu properti. Anda dapat menambahkan lebih banyak antrian dan mengkonfigurasi beberapa properti untuk setiap antrian dalam struktur JSON. Sintaks berikut mewakili struktur JSON yang Anda gunakan untuk mengonfigurasi beberapa antrian dengan beberapa properti: 

```
[
   {
      "ParameterName":"wlm_json_configuration", "ParameterValue":
         "[
             {
                "{{q1_first_property_name}}":"{{q1_first_property_value}}",
                "{{q1_second_property_name}}":"{{q1_second_property_value}}", 
                ...
             },
             {
                "{{q2_first_property_name}}":"{{q2_first_property_value}}",
                "{{q2_second_property_name}}":"{{q2_second_property_value}}", 
                ...
             }
             ...

         ]"
   }
]
```

Dalam contoh sebelumnya, properti representatif yang dimulai dengan ** q1 ** adalah objek dalam array untuk antrian pertama. Masing-masing objek ini adalah name/value pasangan; `name` dan `value` bersama-sama mengatur properti WLM untuk antrian pertama. Properti representatif yang dimulai dengan ** q2 ** adalah objek dalam array untuk antrian kedua. Jika Anda memerlukan lebih banyak antrian, Anda menambahkan array lain untuk setiap antrian tambahan dan mengatur properti untuk setiap objek.

 Saat Anda memodifikasi konfigurasi WLM, Anda harus menyertakan dalam seluruh struktur untuk antrian Anda, bahkan jika Anda hanya ingin mengubah satu properti dalam antrian. Ini karena seluruh struktur JSON diteruskan sebagai string sebagai nilai untuk `wlm_json_configuration` parameter. 

### Memformat AWS CLI perintah
<a name="construct-json-param-value"></a>

`wlm_json_configuration`Parameter memerlukan format tertentu saat Anda menggunakan AWS CLI. Format yang Anda gunakan tergantung pada sistem operasi klien Anda. Sistem operasi memiliki cara yang berbeda untuk melampirkan struktur JSON sehingga diteruskan dengan benar dari baris perintah. Untuk detail tentang cara membangun perintah yang sesuai di sistem operasi Linux, macOS, dan Windows, lihat bagian berikut. Untuk informasi selengkapnya tentang perbedaan dalam melampirkan struktur data JSON AWS CLI secara umum, lihat Mengu [ tip string ](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#quoting-strings) di Panduan *AWS Command Line Interface Pengguna. *

Contoh

Berikut contoh perintah mengonfigurasi manual WLM untuk grup parameter yang dipanggil. `example-parameter-group` Konfigurasi memungkinkan akselerasi kueri pendek dengan waktu berjalan maksimum untuk kueri pendek yang disetel ke 0, yang menginstruksikan WLM untuk mengatur nilai secara dinamis. Peng `ApplyType` aturannya adalah`dynamic`. Pengaturan ini berarti bahwa setiap perubahan yang dilakukan pada properti dinamis dalam parameter diterapkan segera kecuali perubahan statis lainnya telah dilakukan pada konfigurasi. Konfigurasi mendefinisikan tiga antrian dengan yang berikut: 
+  Antrian pertama memungkinkan pengguna untuk menentukan `report` sebagai label (seperti yang ditentukan dalam `query_group` properti) dalam kueri mereka untuk membantu dalam merutekan kueri ke antrian tersebut. Pencarian wildcard diaktifkan untuk `report*` label, sehingga label tidak perlu tepat untuk kueri yang akan dialihkan ke antrian. Misalnya, `reports` dan `reporting` keduanya cocok dengan grup kueri ini. Antrian dialokasikan 25 persen dari total memori di semua antrian, dan dapat menjalankan hingga empat kueri secara bersamaan. Kueri dibatasi hingga waktu maksimum 20000 milidetik (ms). mode diatur ke otomatis, jadi ketika slot kueri antrian penuh, kueri yang memenuhi syarat dikirim ke cluster penskalaan. 
+  Antrian kedua memungkinkan pengguna yang merupakan anggota `admin` atau `dba` grup dalam database untuk memiliki kueri mereka dialihkan ke antrian untuk diproses. Pencarian wildcard dinonaktifkan untuk grup pengguna, sehingga pengguna harus dicocokkan secara tepat dengan grup dalam database agar kueri mereka diarahkan ke antrian. Antrian dialokasikan 40 persen dari total memori di semua antrian, dan dapat menjalankan hingga lima kueri pada saat yang sama. mode diatur ke nonaktif, sehingga semua kueri yang dikirim oleh anggota grup admin atau dba berjalan di cluster utama.
+  Antrian terakhir dalam konfigurasi adalah antrian default. Antrian ini dialokasikan 35 persen dari total memori di semua antrian, dan dapat memproses hingga lima kueri sekaligus. Mode diatur ke otomatis. 

**catatan**  
 Contoh ditampilkan pada beberapa baris untuk tujuan demonstrasi. Perintah aktual seharusnya tidak memiliki jeda baris. 

```
aws redshift modify-cluster-parameter-group 
--parameter-group-name example-parameter-group 
--parameters
'[
  {
    "query_concurrency": 4,
    "max_execution_time": 20000,
    "memory_percent_to_use": 25,
    "query_group": ["report"],
    "query_group_wild_card": 1,
    "user_group": [],
    "user_group_wild_card": 0,
    "user_role": [],
    "user_role_wild_card": 0,
    "concurrency_scaling": "auto", 
    "queue_type": "manual"
  },
  {
    "query_concurrency": 5,
    "memory_percent_to_use": 40,
    "query_group": [],
    "query_group_wild_card": 0,
    "user_group": [
      "admin",
      "dba"
    ],
    "user_group_wild_card": 0,
    "user_role": [],
    "user_role_wild_card": 0,
    "concurrency_scaling": "off",
    "queue_type": "manual"    
  },
  {
    "query_concurrency": 5,
    "query_group": [],
    "query_group_wild_card": 0,
    "user_group": [],
    "user_group_wild_card": 0,
    "user_role": [],
    "user_role_wild_card": 0,
    "concurrency_scaling": "auto",
    "queue_type": "manual"    
  },
  {"short_query_queue": true}
]'
```

Berikut ini adalah contoh konfigurasi aturan pemantauan kueri WLM untuk konfigurasi WLM otomatis. Contoh membuat grup parameter bernama`example-monitoring-rules`. Konfigurasi mendefinisikan tiga antrian yang sama seperti contoh sebelumnya, tetapi `query_concurrency` dan tidak `memory_percent_to_use` ditentukan lagi. Konfigurasi juga menambahkan aturan berikut dan prioritas kueri:
+ Antrian pertama mendefinisikan aturan bernama`rule_1`. Aturan memiliki dua predikat: `query_cpu_time > 10000000` dan`query_blocks_read > 1000`. Tindakan aturan adalah`log`. Prioritas antrian ini adalah`Normal`. 
+ Antrian kedua mendefinisikan aturan bernama`rule_2`. Aturan memiliki dua predikat: `query_execution_time > 600000000` dan`scan_row_count > 1000000000`. Tindakan aturan adalah`abort`. Prioritas antrian ini adalah`Highest`. 
+ Antrian terakhir dalam konfigurasi adalah antrian default. Prioritas antrian ini adalah`Low`. 

**catatan**  
 Contoh ditampilkan pada beberapa baris untuk tujuan demonstrasi. Perintah aktual seharusnya tidak memiliki jeda baris. 

```
aws redshift modify-cluster-parameter-group 
--parameter-group-name example-monitoring-rules 
--parameters
'[ {
  "query_group" : [ "report" ],
  "query_group_wild_card" : 1,
  "user_group" : [ ],
  "user_group_wild_card" : 0,
  "user_role": [ ],
  "user_role_wild_card": 0,
  "concurrency_scaling" : "auto",
  "rules" : [{
    "rule_name": "rule_1",
    "predicate": [{
      "metric_name": "query_cpu_time",
      "operator": ">",
      "value": 1000000 },
      { "metric_name": "query_blocks_read",
      "operator": ">",
      "value": 1000
    } ],
    "action" : "log"
  } ],
   "priority": "normal",
   "queue_type": "auto"
}, {  
  "query_group" : [ ],
  "query_group_wild_card" : 0,
  "user_group" : [ "admin", "dba" ],
  "user_group_wild_card" : 0,
  "user_role": [ ],
  "user_role_wild_card": 0,
  "concurrency_scaling" : "off",
  "rules" : [ {
    "rule_name": "rule_2",
    "predicate": [
      {"metric_name": "query_execution_time",
      "operator": ">",
      "value": 600000000},
      {"metric_name": "scan_row_count",
      "operator": ">",
      "value": 1000000000}],
      "action": "abort"}],
   "priority": "high",
   "queue_type": "auto"

}, {
  "query_group" : [ ],
  "query_group_wild_card" : 0,
  "user_group" : [ ],
  "user_group_wild_card" : 0,
  "user_role": [ ],
  "user_role_wild_card": 0,
  "concurrency_scaling" : "auto",
  "priority": "low",
  "queue_type": "auto",
  "auto_wlm": true
}, {
  "short_query_queue" : true
} ]'
```

#### Mengkonfigurasi WLM dengan menggunakan AWS CLI di baris perintah dengan file JSON
<a name="wlm-cli-json-file"></a>

Anda dapat memodifikasi `wlm_json_configuration` parameter menggunakan AWS CLI dan meneruskan nilai `parameters` argumen sebagai file JSON.

```
aws redshift modify-cluster-parameter-group --parameter-group-name myclusterparaametergroup --parameters file://modify_pg.json 
```

Argumen untuk `--parameters` disimpan dalam file`modify_pg.json`. Lokasi file ditentukan dalam format untuk sistem operasi Anda. Untuk informasi selengkapnya, lihat [ Memuat parameter dari file](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#cli-usage-parameters-file). Berikut ini menunjukkan contoh konten file `modify_pg.json` JSON.

```
[
    {
        "ParameterName": "wlm_json_configuration",
        "ParameterValue": "[{\"user_group\":\"example_user_group1\",\"query_group\": \"example_query_group1\", \"query_concurrency\":7},{\"query_concurrency\":5}]"
    }
]
```

```
[
    {
        "ParameterName": "wlm_json_configuration",
        "ParameterValue": "[{\"query_group\":[\"reports\"],\"query_group_wild_card\":0,\"query_concurrency\":4,\"max_execution_time\":20000,\"memory_percent_to_use\":25},{\"user_group\":[\"admin\",\"dba\"],\"user_group_wild_card\":1,\"query_concurrency\":5,\"memory_percent_to_use\":40},{\"query_concurrency\":5,\"memory_percent_to_use\":35},{\"short_query_queue\": true, \"max_execution_time\": 5000 }]",
        "ApplyType": "dynamic"
    }
]
```

#### Aturan untuk mengkonfigurasi WLM dengan menggunakan AWS CLI di baris perintah pada sistem operasi Linux dan macOS
<a name="wlm-cli-linux-and-mac"></a>

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris:
+ Seluruh struktur JSON harus tertutup dalam tanda kutip tunggal (') dan satu set tanda kurung ([]). 
+ Semua nama parameter dan nilai parameter harus dilampirkan dalam tanda kutip ganda (“).
+ Di dalam `ParameterValue` nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).
+ Dalam struktur bersarang, setiap properti dan nilai untuk setiap antrian harus ditutup dalam kurung kurung keriting ({}).
+ Dalam struktur bersarang, Anda harus menggunakan karakter escape garis miring terbalik (\\) sebelum setiap tanda kutip ganda (“).
+ Untuk name/value pasangan, titik dua (:) memisahkan setiap properti dari nilainya.
+ Setiap name/value pasangan dipisahkan dari yang lain dengan koma (,).
+ Beberapa antrian dipisahkan oleh koma (,) antara akhir penjepit keriting satu antrian (}) dan awal penjepit keriting antrian berikutnya ({).

#### Aturan untuk mengkonfigurasi WLM dengan menggunakan AWS CLI di Windows PowerShell pada sistem operasi Microsoft Windows
<a name="wlm-cli-windows-powershell"></a>

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris:
+ Seluruh struktur JSON harus tertutup dalam tanda kutip tunggal (') dan satu set tanda kurung ([]).
+ Semua nama parameter dan nilai parameter harus dilampirkan dalam tanda kutip ganda (“).
+ Di dalam `ParameterValue` nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).
+ Dalam struktur bersarang, setiap properti dan nilai untuk setiap antrian harus ditutup dalam kurung kurung keriting ({}).
+ Dalam struktur bersarang, Anda harus menggunakan karakter escape garis miring terbalik (\\) sebelum setiap tanda kutip ganda (“) dan karakter escape garis miring terbalik (\\) nya. Persyaratan ini berarti bahwa Anda akan menggunakan tiga garis miring terbalik dan tanda kutip ganda untuk memastikan bahwa properti diteruskan dengan benar (\\\\\\”).
+ Untuk name/value pasangan, titik dua (:) memisahkan setiap properti dari nilainya.
+ Setiap name/value pasangan dipisahkan dari yang lain dengan koma (,).
+ Beberapa antrian dipisahkan oleh koma (,) antara akhir penjepit keriting satu antrian (}) dan awal penjepit keriting antrian berikutnya ({).

#### Aturan untuk mengkonfigurasi WLM dengan menggunakan command prompt pada sistem operasi Windows
<a name="wlm-cli-cmd-windows"></a>

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris:
+ Seluruh struktur JSON harus dilampirkan dalam tanda kutip ganda (“) dan satu set tanda kurung ([]).
+ Semua nama parameter dan nilai parameter harus dilampirkan dalam tanda kutip ganda (“).
+ Di dalam `ParameterValue` nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).
+ Dalam struktur bersarang, setiap properti dan nilai untuk setiap antrian harus ditutup dalam kurung kurung keriting ({}).
+ Dalam struktur bersarang, Anda harus menggunakan karakter escape garis miring terbalik (\\) sebelum setiap tanda kutip ganda (“) dan karakter escape garis miring terbalik (\\) nya. Persyaratan ini berarti bahwa Anda akan menggunakan tiga garis miring terbalik dan tanda kutip ganda untuk memastikan bahwa properti diteruskan dengan benar (\\\\\\”).
+ Untuk name/value pasangan, titik dua (:) memisahkan setiap properti dari nilainya.
+ Setiap name/value pasangan dipisahkan dari yang lain dengan koma (,).
+ Beberapa antrian dipisahkan oleh koma (,) antara akhir penjepit keriting satu antrian (}) dan awal penjepit keriting antrian berikutnya ({).