Mengkonfigurasi manajemen beban kerja - Amazon Redshift
Sifat dinamis dan statis WLMProperti untuk parameter wlm_json_configuration Mengkonfigurasi parameter wlm_json_configuration menggunakan AWS CLI

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

Mengkonfigurasi manajemen beban kerja

Di Amazon Redshift, Anda menggunakan manajemen beban kerja (WLM) untuk menentukan jumlah antrian kueri yang tersedia, dan cara kueri dirutekan ke antrian tersebut untuk diproses. WLM adalah bagian dari konfigurasi grup parameter. Sebuah cluster menggunakan konfigurasi WLM yang ditentukan dalam kelompok 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 jika Anda ingin lebih banyak kontrol atas pemrosesan kueri. Setiap antrian yang Anda tambahkan memiliki konfigurasi WLM default yang sama hingga Anda mengonfigurasi propertinya.

Saat Anda menambahkan antrian tambahan, antrian terakhir dalam konfigurasi adalah antrian default. Kecuali kueri dirutekan ke antrian lain berdasarkan kriteria dalam konfigurasi WLM, itu 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 itu 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 wlm_json_configuration

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 berjalan 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 Panduan WLM
WLM otomatis Ya Ya
Aktifkan akselerasi kueri singkat Ya Ya
Waktu berjalan maksimum untuk kueri singkat Ya Ya
Prioritas Ya Tidak
Jenis antrian Ya Ya
Nama antrian Ya Ya
Mode Penskalaan Konkurensi Ya Ya
Konkurensi Tidak Ya
Grup pengguna Ya Ya
Wildcard grup pengguna Ya Ya
Grup kueri Ya Ya
Wildcard grup kueri Ya Ya
Peran pengguna Ya Ya
Wildcard peran pengguna Ya Ya
Waktu habis Tidak Dihentikan
Memori Tidak Ya
Aturan Pemantauan Kueri Ya Ya

Daftar berikut menjelaskan properti WLM yang dapat Anda konfigurasi.

WLM otomatis

Auto WLM diatur untuk true mengaktifkan WLM otomatis. WLM otomatis menetapkan nilai untuk Concurrency pada main dan Memory (%) ke. Auto Amazon Redshift mengelola konkurensi kueri dan alokasi memori. Nilai default-nya true.

Properti JSON: auto_wlm

Aktifkan akselerasi kueri singkat

Akselerasi kueri singkat (SQA) memprioritaskan kueri jangka pendek yang dipilih sebelum kueri yang berjalan lebih lama. SQA mengeksekusi kueri jangka pendek di ruang khusus, sehingga kueri SQA tidak dipaksa untuk menunggu dalam antrian di belakang kueri yang lebih panjang. Dengan SQA, kueri jangka pendek mulai dijalankan lebih cepat dan pengguna melihat hasilnya lebih cepat. Ketika Anda mengaktifkan SQA, Anda juga dapat menentukan waktu berjalan maksimum untuk kueri singkat. Untuk mengaktifkan SQA, tentukantrue. Nilai default-nya false. Pengaturan ini diterapkan untuk setiap kelompok parameter daripada antrian.

Properti JSON: short_query_queue

Waktu berjalan maksimum untuk kueri singkat

Saat Anda mengaktifkan SQA, Anda dapat menentukan 0 untuk membiarkan WLM secara dinamis mengatur waktu berjalan maksimum untuk kueri singkat. Atau, Anda dapat menentukan nilai 1-20 detik, dalam milidetik. Nilai default-nya adalah 0.

Properti JSON: max_execution_time

Prioritas

Prioritas menetapkan prioritas kueri yang berjalan dalam antrian. Untuk mengatur prioritas, mode WLM harus diatur ke Auto WLM; artinya, harus. auto_wlm true Nilai prioritas dapat berupahighest,high,normal,low, danlowest. Nilai default-nya normal.

Properti JSON: priority

Jenis antrian

Jenis antrian menunjuk antrian seperti yang digunakan baik oleh Auto WLM atau Manual WLM. Setel queue_type ke salah satu auto ataumanual. 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, hingga 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 dihasilkan oleh Amazon Redshift. Nama default antrian adalahQueue 1,Queue 2, ke antrian terakhir bernama. Default queue

penting

Jika Anda mengubah nama antrian, nilai QueueName dimensi metrik antrian WLM (seperti, WLM, QueueWait Waktu WLM, WLMQueueLength, WLM, WLM, dan sebagainya QueriesCompletedPerSecond) juga berubah. QueryDuration RunningQueries 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 dirutekan ke antrian melebihi konkurensi antrian yang dikonfigurasi, kueri yang memenuhi syarat akan masuk ke klaster penskalaan. Ketika slot tersedia, kueri berjalan di cluster utama. Nilai default-nya off.

Properti JSON: concurrency_scaling

Konkurensi

Jumlah kueri 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 klaster 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 dirutekan ke antrian yang terkait dengan grup pengguna mereka.

Properti JSON: user_group

Grup Pengguna Wildcard

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.

Properti JSON: user_group_wild_card

Grup Kueri

Daftar grup kueri yang dipisahkan koma. Saat anggota grup kueri menjalankan kueri dalam database, kueri mereka dirutekan 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.

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 dirutekan ke antrian yang terkait dengan peran pengguna mereka. Untuk informasi selengkapnya tentang peran pengguna, lihat Kontrol akses berbasis peran (RBAC).

Properti JSON: user_role

Peran Pengguna Wildcard

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.

Properti JSON: user_role_wild_card

Batas waktu (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 WLM.

Waktu maksimum, dalam milidetik, kueri dapat berjalan sebelum dibatalkan. Dalam beberapa kasus, kueri hanya-baca, 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. Batas waktu WLM tidak berlaku untuk kueri yang telah mencapai status. returning Untuk melihat status kueri, lihat tabel sistem STV_WLM_QUERY_STATE.

Properti JSON: max_execution_time

Memori (%)

Persentase memori untuk 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 sementara dapat memberikan 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 menggunakan sumber daya sistem yang berlebihan, dan kemudian memulai tindakan tertentu ketika kueri melebihi batas kinerja yang ditentukan.

catatan

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

Hirarki 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 mencapai 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 pemantauan kueri di Panduan Pengembang Database Amazon Redshift.

      • operatorOperasi adalah=,<, dan>.

      • value— Nilai ambang batas untuk metrik tertentu yang memicu tindakan.

  • actionSetiap 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 query WLM bernamarule_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 Menerapkan manajemen beban kerja di Panduan Pengembang Database Amazon Redshift.

Mengkonfigurasi parameter wlm_json_configuration menggunakan AWS CLI

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

catatan

Jika Anda mengonfigurasi WLM dengan 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 mengonfigurasi WLM menggunakan konsol, lihat. Mengubah grup parameter

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 mengkonfigurasi 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 pasangan nama/nilai; 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.

Ketika Anda memodifikasi konfigurasi WLM, Anda harus menyertakan 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 perintah AWS CLI

wlm_json_configurationParameter memerlukan format tertentu saat Anda menggunakan file 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 membuat perintah yang sesuai di sistem operasi Linux, Mac OS X, dan Windows, lihat bagian berikut. Untuk informasi selengkapnya tentang perbedaan dalam melampirkan struktur data JSON secara umum, lihat Mengutip string di Panduan Pengguna. AWS CLI AWS Command Line Interface

Contoh

Contoh perintah berikut mengkonfigurasi WLM manual untuk kelompok parameter yang disebut. example-parameter-group Konfigurasi ini memungkinkan akselerasi kueri pendek dengan waktu berjalan maksimum untuk kueri pendek yang disetel ke 0, yang menginstruksikan WLM untuk mengatur nilai secara dinamis. ApplyTypePengaturannya adalahdynamic. Pengaturan ini berarti bahwa setiap perubahan yang dibuat 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 diarahkan 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 pada saat yang bersamaan. Kueri dibatasi hingga waktu maksimum 20000 milidetik (ms). mode diatur ke auto, 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 mengarahkan kueri mereka ke antrian untuk diproses. Pencarian wildcard dinonaktifkan untuk grup pengguna, sehingga pengguna harus dicocokkan persis dengan grup dalam database agar kueri mereka dialihkan 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 off, sehingga semua kueri yang dikirim oleh anggota admin atau grup 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 auto.

catatan

Contoh ditampilkan pada beberapa baris untuk tujuan demonstrasi. Perintah yang sebenarnya 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 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 dan prioritas kueri berikut:

  • Antrian pertama mendefinisikan aturan bernama. rule_1 Aturan ini memiliki dua predikat: query_cpu_time > 10000000 danquery_blocks_read > 1000. Tindakan aturannya adalahlog. Prioritas antrian ini adalahNormal.

  • Antrian kedua mendefinisikan aturan bernama. rule_2 Aturan ini memiliki dua predikat: query_execution_time > 600000000 danscan_row_count > 1000000000. Tindakan aturannya adalahabort. Prioritas antrian ini adalahHighest.

  • Antrian terakhir dalam konfigurasi adalah antrian default. Prioritas antrian ini adalahLow.

catatan

Contoh ditampilkan pada beberapa baris untuk tujuan demonstrasi. Perintah yang sebenarnya 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

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 isi 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 baris perintah AWS CLI pada sistem operasi Linux dan macOS X

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

  • Seluruh struktur JSON harus dilampirkan dalam tanda kutip tunggal (') dan satu set tanda kurung ([]).

  • Semua nama parameter dan nilai parameter harus diapit tanda kutip ganda (“).

  • Dalam ParameterValue nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).

  • Dalam struktur bersarang, masing-masing properti dan nilai untuk setiap antrian harus diapit kurung kurawal ({}).

  • Dalam struktur bersarang, Anda harus menggunakan karakter escape backslash (\) sebelum setiap tanda kutip ganda (“).

  • Untuk pasangan nama/nilai, titik dua (:) memisahkan setiap properti dari nilainya.

  • Setiap pasangan nama/nilai dipisahkan dari yang lain dengan koma (,).

  • Beberapa antrian dipisahkan oleh koma (,) antara akhir kurung kurawal antrian (}) dan awal kurung kurawal antrian berikutnya ({).

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

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

  • Seluruh struktur JSON harus dilampirkan dalam tanda kutip tunggal (') dan satu set tanda kurung ([]).

  • Semua nama parameter dan nilai parameter harus diapit tanda kutip ganda (“).

  • Dalam ParameterValue nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).

  • Dalam struktur bersarang, masing-masing properti dan nilai untuk setiap antrian harus diapit kurung kurawal ({}).

  • Dalam struktur bersarang, Anda harus menggunakan karakter escape backslash (\) sebelum setiap tanda kutip ganda (“) dan karakter escape garis miring terbalik (\). Persyaratan ini berarti bahwa Anda akan menggunakan tiga garis miring terbalik dan tanda kutip ganda untuk memastikan bahwa properti diteruskan dengan benar (\\\”).

  • Untuk pasangan nama/nilai, titik dua (:) memisahkan setiap properti dari nilainya.

  • Setiap pasangan nama/nilai dipisahkan dari yang lain dengan koma (,).

  • Beberapa antrian dipisahkan oleh koma (,) antara akhir kurung kurawal antrian (}) dan awal kurung kurawal antrian berikutnya ({).

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:

  • Seluruh struktur JSON harus diapit tanda kutip ganda (“) dan satu set tanda kurung ([]).

  • Semua nama parameter dan nilai parameter harus diapit tanda kutip ganda (“).

  • Dalam ParameterValue nilai, Anda harus melampirkan seluruh struktur bersarang dalam tanda kutip ganda (“) dan tanda kurung ([]).

  • Dalam struktur bersarang, masing-masing properti dan nilai untuk setiap antrian harus diapit kurung kurawal ({}).

  • Dalam struktur bersarang, Anda harus menggunakan karakter escape backslash (\) sebelum setiap tanda kutip ganda (“) dan karakter escape garis miring terbalik (\). Persyaratan ini berarti bahwa Anda akan menggunakan tiga garis miring terbalik dan tanda kutip ganda untuk memastikan bahwa properti diteruskan dengan benar (\\\”).

  • Untuk pasangan nama/nilai, titik dua (:) memisahkan setiap properti dari nilainya.

  • Setiap pasangan nama/nilai dipisahkan dari yang lain dengan koma (,).

  • Beberapa antrian dipisahkan oleh koma (,) antara akhir kurung kurawal antrian (}) dan awal kurung kurawal antrian berikutnya ({).