Memasukkan parameter dataset ke SQL kustom

Anda dapat menyisipkan parameter dataset ke SQL kustom dari dataset dalam mode query langsung dengan mereferensikannya dengan <<$parameter_name>> dalam pernyataan SQL. Saat runtime, pengguna dasbor dapat memasukkan nilai kontrol filter yang terkait dengan parameter kumpulan data. Kemudian, mereka dapat melihat hasilnya di visual dasbor setelah nilai menyebar ke kueri SQL. Anda dapat menggunakan parameter untuk membuat filter dasar berdasarkan masukan pelanggan dalam where klausa. Atau, Anda dapat menambahkan case when atau if else klausa untuk secara dinamis mengubah logika kueri SQL berdasarkan input parameter.

Misalnya, Anda ingin menambahkan WHERE klausa ke SQL kustom Anda yang memfilter data berdasarkan nama Wilayah pengguna akhir. Dalam hal ini, Anda membuat parameter nilai tunggal yang disebutRegionName:

SELECT *
FROM transactions
WHERE region = <<$RegionName>>

Anda juga dapat membiarkan pengguna memberikan beberapa nilai ke parameter:

SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)

Dalam contoh yang lebih kompleks berikut, penulis dataset mengacu pada dua parameter dataset dua kali berdasarkan nama depan dan belakang pengguna yang dapat dipilih dalam kontrol filter dasbor:

SELECT Region, Country, OrderDate, Sales
FROM transactions
WHERE region=
(Case
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region1') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region1') 
    THEN 'region1'
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region2') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region2') 
    THEN 'region2'
ELSE 'region3'
END)

Anda juga dapat menggunakan parameter dalam SELECT klausa untuk membuat kolom baru dalam kumpulan data dari input pengguna:

SELECT Region, Country, date, 
    (case 
    WHEN <<$RegionName>>='EU'
    THEN sum(sales) * 0.93   --convert US dollar to euro
    WHEN <<$RegionName>>='CAN'
    THEN sum(sales) * 0.78   --convert US dollar to Canadian Dollar
    ELSE sum(sales) -- US dollar
    END
    ) as "Sales"
FROM transactions
WHERE region = <<$RegionName>>

Untuk membuat kueri SQL kustom atau mengedit kueri yang ada sebelum menambahkan parameter kumpulan data, lihat. Menggunakan SQL untuk menyesuaikan data

Bila Anda menerapkan SQL kustom dengan parameter dataset, <<$parameter_name>> digunakan sebagai nilai placeholder. Saat pengguna memilih salah satu nilai parameter dari kontrol, QuickSight ganti placeholder dengan nilai yang dipilih pengguna di dasbor.

Dalam contoh berikut, pengguna memasukkan kueri SQL kustom baru yang memfilter data berdasarkan status:

select * from all_flights
where origin_state_abr = <<$State>>

Nilai default parameter diterapkan ke kueri SQL dan hasilnya muncul di panel Pratinjau. Pada tangkapan layar berikut, nilai default State parameter adalahIL, atau Illinois. Kueri SQL memfilter data dari kumpulan data dan mengembalikan semua entri dalam kumpulan data tempat status asal berada. IL