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 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

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

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 WLM.

Properti untuk parameter konfigurasi WLM

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.

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

Daftar berikut menjelaskan properti WLM yang dapat Anda konfigurasi.

Untuk informasi selengkapnya tentang masing-masing properti dan strategi untuk mengonfigurasi antrian kueri, lihat Mener apkan manajemen beban kerja di Panduan Pengembang Database Amazon Redshift.

Mengkonfigurasi parameter WLM menggunakan AWS CLI

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

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

wlm_json_configurationParameter 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 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 adalahdynamic. 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:

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 bernamaexample-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:

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

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 filemodify_pg.json. Lokasi file ditentukan dalam format untuk sistem operasi Anda. Untuk informasi selengkapnya, lihat Memuat parameter dari 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

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris:

Aturan untuk mengkonfigurasi WLM dengan menggunakan AWS CLI di Windows PowerShell pada sistem operasi Microsoft Windows

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris:

Aturan untuk mengkonfigurasi WLM dengan menggunakan command prompt pada sistem operasi Windows

Ikuti aturan ini untuk menjalankan AWS CLI perintah dengan parameter pada satu baris: