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

# Memasukkan parameter dataset ke SQL kustom
<a name="dataset-parameters-insert-parameter"></a>

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 disebut`RegionName`:

```
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](adding-a-SQL-query.md)

Bila Anda menerapkan SQL kustom dengan parameter dataset, `<<$parameter_name>>` digunakan sebagai nilai placeholder. Saat pengguna memilih salah satu nilai parameter dari kontrol, Quick menggantikan 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**.