Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan parameter dataset di Amazon Quick
Di Amazon Quick, penulis dapat menggunakan parameter kumpulan data dalam kueri langsung untuk menyesuaikan kumpulan data mereka secara dinamis dan menerapkan logika yang dapat digunakan kembali ke kumpulan data mereka. Parameter *dataset adalah parameter* yang dibuat pada tingkat dataset. Ini dikonsumsi oleh parameter analisis melalui kontrol, bidang terhitung, filter, tindakan URLs, judul, dan deskripsi. Untuk informasi lebih lanjut tentang parameter analisis, lihat[Parameter di Amazon Cepat](parameters-in-quicksight.md). Daftar berikut menjelaskan tiga tindakan yang dapat dilakukan dengan parameter dataset:
+ **SQL kustom dalam kueri langsung** - Pemilik dataset dapat memasukkan parameter dataset ke dalam SQL kustom dari dataset kueri langsung. Ketika parameter ini diterapkan ke kontrol filter dalam analisis Cepat, pengguna dapat memfilter data kustom mereka lebih cepat dan lebih efisien.
+ **Variabel berulang** — Nilai statis yang muncul di beberapa lokasi di halaman dataset dapat dimodifikasi dalam satu tindakan menggunakan parameter dataset kustom.
+ **Memindahkan bidang terhitung ke kumpulan data** — Penulis cepat dapat menyalin bidang terhitung dengan parameter dalam analisis dan memigrasikannya ke tingkat kumpulan data. Ini melindungi bidang terhitung pada tingkat analisis agar tidak dimodifikasi secara tidak sengaja dan bidang terhitung dibagikan di beberapa analisis.
Dalam beberapa situasi, parameter kumpulan data meningkatkan kinerja kontrol filter untuk kumpulan data kueri langsung yang memerlukan SQL khusus yang kompleks dan menyederhanakan logika bisnis di tingkat kumpulan data.
**Topics**
+ [Batasan parameter set data](#dataset-parameters-limitations)
+ [Membuat parameter kumpulan data di Amazon Quick](dataset-parameters-SQL.md)
+ [Memasukkan parameter dataset ke SQL kustom](dataset-parameters-insert-parameter.md)
+ [Menambahkan parameter dataset ke bidang terhitung](dataset-parameters-calculated-fields.md)
+ [Menambahkan parameter dataset ke filter](dataset-parameters-dataset-filters.md)
+ [Menggunakan parameter dataset dalam analisis Cepat](dataset-parameters-analysis.md)
+ [Kasus penggunaan lanjutan dari parameter dataset](dataset-parameters-advanced-options.md)
## Batasan parameter set data
Bagian ini mencakup batasan yang diketahui yang mungkin Anda temui saat bekerja dengan parameter kumpulan data di Amazon Quick.
+ Saat pembaca dasbor menjadwalkan laporan yang dikirim melalui email, kontrol yang dipilih tidak menyebar ke parameter kumpulan data yang disertakan dalam laporan yang dilampirkan ke email. Sebagai gantinya, nilai default parameter digunakan.
+ Parameter kumpulan data tidak dapat dimasukkan ke dalam SQL kustom kumpulan data yang disimpan di SPICE.
+ Default dinamis hanya dapat dikonfigurasi pada halaman analisis analisis yang menggunakan dataset. Anda tidak dapat mengonfigurasi default dinamis di tingkat kumpulan data.
+ Opsi **Pilih semua** tidak didukung pada kontrol multivalue parameter analisis yang dipetakan ke parameter kumpulan data.
+ Kontrol Cascading tidak didukung untuk parameter kumpulan data.
+ Parameter dataset hanya dapat digunakan oleh filter dataset saat dataset menggunakan kueri langsung.
+ Dalam kueri SQL khusus, hanya 128 parameter kumpulan data yang dapat digunakan.
# Membuat parameter kumpulan data di Amazon Quick
Gunakan prosedur berikut untuk memulai menggunakan parameter dataset.
**Untuk membuat parameter dataset baru**
1. **Dari halaman Mulai cepat, pilih **Data** di sebelah kiri, pilih elipsis (tiga titik) di sebelah kumpulan data yang ingin Anda ubah, lalu pilih Edit.**
1. Pada halaman **Dataset** yang terbuka, pilih **Parameter** di sebelah kiri, lalu pilih ikon (\$1) untuk membuat parameter dataset baru.
1. Dalam pop-up **Buat parameter baru** yang muncul, masukkan nama parameter di **Nama** kotak.
1. Di dropdown **tipe Data**, pilih tipe data parameter yang Anda inginkan. Tipe data yang didukung adalah `String``Integer`,`Number`,, dan`Datetime`. Opsi ini tidak dapat diubah setelah parameter dibuat.
1. Untuk **nilai Default**, masukkan nilai default yang Anda inginkan parameter untuk memiliki.
**catatan**
Saat Anda memetakan parameter kumpulan data ke parameter analisis, nilai default yang berbeda dapat dipilih. Ketika ini terjadi, nilai default yang dikonfigurasi di sini diganti dengan nilai default baru.
1. Untuk **Nilai**, pilih jenis nilai yang Anda inginkan parameter untuk memiliki. Parameter **nilai tunggal** mendukung dropdown tunggal, bidang teks, dan kontrol daftar. **Beberapa parameter nilai** mendukung kontrol tarik-turun multi—pilih. Opsi ini tidak dapat diubah setelah parameter dibuat.
1. Ketika Anda selesai mengkonfigurasi parameter baru, pilih **Buat** untuk membuat parameter.
# 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 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**.
# Menambahkan parameter dataset ke bidang terhitung
Anda juga dapat menambahkan parameter kumpulan data ke ekspresi bidang terhitung menggunakan format`${parameter_name}`.
Saat Anda membuat perhitungan, Anda dapat memilih dari parameter yang ada dari daftar parameter di bawah daftar **Parameter**. Anda tidak dapat membuat bidang terhitung yang berisi parameter multivalued.
Untuk informasi selengkapnya tentang menambahkan bidang terhitung, lihat[Menggunakan bidang terhitung dengan parameter di Amazon Quick](parameters-calculated-fields.md).
# Menambahkan parameter dataset ke filter
Untuk kumpulan data dalam mode kueri langsung, penulis kumpulan data dapat menggunakan parameter kumpulan data dalam filter tanpa SQL khusus. Parameter dataset tidak dapat ditambahkan ke filter jika dataset ada di SPICE.
**Untuk menambahkan parameter dataset ke filter**
1. Buka halaman kumpulan data dari kumpulan data yang ingin Anda buat filter. Pilih **Filter** di sebelah kiri, lalu pilih **Tambahkan filter**.
1. Masukkan nama yang Anda inginkan untuk dimiliki filter dan pilih bidang yang ingin Anda filter di dropdown.
1. **Setelah Anda membuat filter baru, arahkan ke filter di panel **Filter**, pilih elipsis (tiga titik) di sebelah filter, lalu pilih Edit.**
1. Untuk **jenis Filter**, pilih **Filter khusus**.
1. Untuk **kondisi Filter**, pilih kondisi yang Anda inginkan.
1. Pilih kotak **Use parameter** dan pilih parameter dataset yang Anda inginkan filter untuk digunakan.
1. Setelah selesai melakukan perubahan, pilih **Terapkan**.
# Menggunakan parameter dataset dalam analisis Cepat
Setelah Anda membuat parameter dataset, setelah Anda menambahkan dataset ke analisis, petakan parameter dataset ke parameter analisis baru atau yang sudah ada. Setelah Anda memetakan parameter kumpulan data ke parameter analisis, Anda dapat menggunakannya dengan filter, kontrol, dan fitur parameter analisis lainnya.
Anda dapat mengelola parameter kumpulan data Anda di panel **Parameter** analisis yang menggunakan kumpulan data yang menjadi milik parameter tersebut. Di bagian **Parameter Dataset** dari panel **Parameter**, Anda dapat memilih untuk hanya melihat parameter kumpulan data yang tidak dipetakan (default). **Atau, Anda dapat memilih untuk melihat semua parameter kumpulan data yang dipetakan dan tidak dipetakan dengan memilih **SEMUA** dari menu tarik-turun Melihat.**
## Memetakan parameter kumpulan data dalam analisis Cepat baru
Saat Anda membuat analisis baru dari kumpulan data yang berisi parameter, Anda perlu memetakan parameter kumpulan data ke analisis sebelum Anda dapat menggunakannya. Ini juga berlaku ketika Anda menambahkan kumpulan data dengan parameter ke analisis. Anda dapat melihat semua parameter yang belum dipetakan dalam analisis di panel **Parameter** analisis. Atau, pilih **LIHAT** di pesan notifikasi yang muncul di kanan atas halaman saat Anda membuat analisis atau menambahkan kumpulan data.
**Untuk memetakan parameter dataset ke parameter analisis**
1. Buka [konsol Cepat](https://quicksight.aws.amazon.com/).
1. Pilih analisis yang ingin Anda ubah.
1. Pilih ikon **Parameter** untuk membuka panel **Parameter**.
1. Pilih elipsis (tiga titik) di sebelah parameter kumpulan data yang ingin Anda petakan, pilih **Parameter Peta**, lalu pilih parameter analisis yang ingin Anda petakan parameter kumpulan data Anda.
Jika analisis Anda tidak memiliki parameter analisis apa pun, Anda dapat memilih **parameter Peta** dan **Buat baru** untuk membuat parameter analisis yang secara otomatis dipetakan ke parameter kumpulan data saat pembuatan.
1. (Opsional) Dalam pop-up **Buat parameter baru** yang muncul, untuk **Nama**, masukkan nama untuk parameter analisis baru.
1. (Opsional) Untuk **nilai default Statis**, pilih nilai default statis yang Anda inginkan parameter untuk memiliki.
1. (Opsional) **Pilih Tetapkan default dinamis** untuk mengatur default dinamis untuk parameter baru.
1. Dalam tabel **parameter dataset yang dipetakan**, Anda akan melihat parameter dataset yang Anda petakan ke parameter analisis baru. Anda dapat menambahkan parameter kumpulan data lain ke parameter analisis ini dengan memilih tarik-turun **ADD DATASET PARAMETER** dan kemudian memilih parameter yang ingin Anda petakan. Anda dapat membatalkan peta parameter kumpulan data dengan memilih tombol **Hapus** di sebelah parameter kumpulan data yang ingin Anda hapus.
Untuk informasi selengkapnya tentang membuat parameter analisis, lihat[Menyiapkan parameter di Amazon Quick](parameters-set-up.md).
Saat Anda memetakan parameter kumpulan data ke parameter analisis, parameter analisis mewakili parameter kumpulan data di mana pun parameter tersebut digunakan dalam analisis.
Anda juga dapat memetakan dan membongkar parameter kumpulan data ke parameter analisis di jendela **Edit parameter**. **Untuk membuka jendela **Edit parameter**, navigasikan ke panel **Parameter**, pilih elipsis (tiga titik) di sebelah parameter analisis yang ingin Anda ubah, lalu pilih Edit parameter.** Anda dapat menambahkan parameter kumpulan data lain ke parameter analisis ini dengan memilih tarik-turun **ADD DATASET PARAMETER** dan kemudian memilih parameter yang ingin Anda petakan. Anda dapat membatalkan peta parameter kumpulan data dengan memilih tombol **Hapus** di sebelah parameter kumpulan data yang ingin Anda hapus. Anda juga dapat menghapus semua parameter kumpulan data yang dipetakan dengan memilih **HAPUS** SEMUA. Setelah selesai melakukan perubahan, pilih **Perbarui**.
**Saat Anda menghapus parameter analisis, semua parameter kumpulan data tidak dipetakan dari analisis dan muncul di bagian **UNMAPPED pada panel** Parameter.** Anda hanya dapat memetakan parameter dataset ke satu parameter analisis pada satu waktu. Untuk memetakan parameter dataset ke parameter analisis yang berbeda, hapus peta parameter dataset dan kemudian petakan ke parameter analisis baru.
## Menambahkan kontrol filter ke parameter analisis yang dipetakan
Setelah memetakan parameter kumpulan data ke parameter analisis di Quick, Anda dapat membuat kontrol filter untuk filter, tindakan, bidang terhitung, judul, deskripsi, dan. URLs
**Untuk menambahkan kontrol ke parameter yang dipetakan**
1. **Di panel **Parameter** halaman analisis, pilih elipsis (tiga titik) di sebelah parameter analisis yang dipetakan yang Anda inginkan, lalu pilih Tambahkan kontrol.**
1. Di jendela **Tambahkan kontrol** yang muncul, masukkan **Nama** yang Anda inginkan dan pilih **Gaya** yang Anda inginkan untuk kontrol. Untuk kontrol nilai tunggal, pilih antara`Dropdown`,`List`, dan`Text field`. Untuk kontrol multivalue, pilih. `Dropdown`
1. Pilih **Tambah** untuk membuat kontrol.
# Kasus penggunaan lanjutan dari parameter dataset
Bagian ini mencakup opsi yang lebih canggih dan kasus penggunaan yang bekerja dengan parameter kumpulan data dan kontrol tarik-turun. Gunakan panduan berikut untuk membuat nilai tarik-turun dinamis dengan parameter kumpulan data.
## Menggunakan kontrol multivalue dengan parameter dataset
Saat Anda menggunakan parameter kumpulan data yang dimasukkan ke dalam SQL kustom dari kumpulan data, parameter kumpulan data biasanya memfilter data berdasarkan nilai dari kolom tertentu. Jika Anda membuat kontrol dropdown dan menetapkan parameter sebagai nilai, dropdown hanya menunjukkan nilai yang difilter parameter. Prosedur berikut menunjukkan bagaimana Anda dapat membuat kontrol yang dipetakan ke parameter dataset dan menampilkan semua nilai yang tidak difilter.
**Untuk mengisi semua nilai yang ditetapkan dalam kontrol tarik-turun**
1. Buat kumpulan data kolom tunggal baru di SPICE atau kueri langsung yang mencakup semua nilai unik dari kumpulan data asli. Sebagai contoh, katakanlah bahwa dataset asli Anda menggunakan SQL kustom berikut:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
Untuk membuat tabel kolom tunggal dengan semua status asal yang unik, terapkan SQL kustom berikut ke kumpulan data baru:
```
SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc
```
Ekspresi SQL mengembalikan semua status unik dalam urutan abjad. Dataset baru tidak memiliki parameter kumpulan data apa pun.
1. Masukkan **Nama** untuk kumpulan data baru, lalu simpan dan publikasikan kumpulan data. Dalam contoh kita, dataset baru dipanggil`State Codes`.
1. Buka analisis yang berisi dataset asli, dan tambahkan dataset baru ke analisis. Untuk informasi tentang menambahkan kumpulan data ke analisis yang ada, lihat. [Menambahkan dataset ke analisis](adding-a-data-set-to-an-analysis.md)
1. Arahkan ke panel **Kontrol** dan temukan kontrol tarik-turun yang ingin Anda edit. **Pilih elipsis (tiga titik) di sebelah kontrol, lalu pilih Edit.**
1. Dalam **kontrol Format** yang muncul di sebelah kiri, dan pilih **Tautkan ke bidang kumpulan data** di bagian **Nilai**.
1. Untuk dropdown **Dataset** yang muncul, pilih dataset baru yang Anda buat. Dalam contoh kami, `State Codes` kumpulan data dipilih.
1. Untuk dropdown **Field** yang muncul, pilih bidang yang sesuai. Dalam contoh kita, `origin_state_abr` bidang dipilih.
Setelah Anda selesai menautkan kontrol ke kumpulan data baru, semua nilai unik muncul di dropdown kontrol. Ini termasuk nilai yang disaring oleh parameter dataset.
## Menggunakan kontrol dengan Pilih semua opsi
Secara default, ketika satu atau beberapa parameter dataset dipetakan ke parameter analisis dan ditambahkan ke kontrol, `Select all` opsi tidak tersedia. Prosedur berikut menunjukkan solusi yang menggunakan skenario contoh yang sama dari bagian sebelumnya.
**catatan**
Panduan ini untuk kumpulan data yang cukup kecil untuk dimuat dalam kueri langsung. Jika Anda memiliki kumpulan data yang besar dan ingin menggunakan `Select All` opsi tersebut, Anda disarankan untuk memuat kumpulan data ke SPICE. Namun, jika Anda ingin menggunakan `Select All` opsi dengan parameter kumpulan data, panduan ini menjelaskan cara untuk melakukannya.
Untuk memulai, katakanlah Anda memiliki dataset kueri langsung dengan SQL kustom yang berisi parameter multivalue yang disebut: `States`
```
select * from all_flights
where origin_state_abr in (<<$States>>)
```
**Untuk menggunakan opsi Pilih semua dalam kontrol yang menggunakan parameter kumpulan data**
1. Di panel **Parameter** analisis, temukan parameter kumpulan data yang ingin Anda gunakan dan pilih **Edit** dari elipsis (tiga titik) di sebelah parameter.
1. Di jendela **Edit parameter** yang muncul, masukkan nilai default baru di bagian **Nilai default statis**. Dalam contoh kita, nilai defaultnya adalah` All States`. Perhatikan bahwa contoh menggunakan karakter spasi utama sehingga nilai default muncul sebagai item pertama dalam kontrol.
1. Pilih **Perbarui** untuk memperbarui parameter.
1. Arahkan ke dataset yang berisi parameter dataset yang Anda gunakan di. analysis-by-analysis Edit SQL kustom dari kumpulan data untuk menyertakan kasus penggunaan default untuk beberapa nilai default statis baru Anda. Menggunakan ` All States` contoh, ekspresi SQL muncul sebagai berikut:
```
select * from public.all_flights
where
' All States' in (<<$States>>) or
origin_state_abr in (<<$States>>)
```
Jika pengguna memilih ` All States` dalam kontrol, ekspresi SQL baru mengembalikan semua catatan unik. Jika pengguna memilih nilai yang berbeda dari kontrol, kueri mengembalikan nilai yang disaring oleh parameter dataset.
### Menggunakan kontrol dengan Pilih semua dan opsi multivalue
Anda dapat menggabungkan `Select all` prosedur sebelumnya dengan metode kontrol multivalue yang dibahas sebelumnya untuk membuat kontrol dropdown yang berisi `Select all` nilai selain beberapa nilai yang dapat dipilih pengguna. Panduan ini mengasumsikan bahwa Anda telah mengikuti prosedur sebelumnya, bahwa Anda tahu cara memetakan parameter kumpulan data ke parameter analisis, dan bahwa Anda dapat membuat kontrol dalam analisis. Untuk informasi selengkapnya tentang parameter analisis pemetaan, lihat[Memetakan parameter kumpulan data dalam analisis Cepat baru](dataset-parameters-analysis.md#dataset-parameters-map-to-analysis). Untuk informasi selengkapnya tentang membuat kontrol dalam analisis yang menggunakan parameter kumpulan data, lihat[Menambahkan kontrol filter ke parameter analisis yang dipetakan](dataset-parameters-analysis.md#dataset-parameters-analysis-filter-control).
**Untuk menambahkan beberapa nilai ke kontrol dengan opsi Pilih semua dan parameter kumpulan data yang dipetakan**
1. Buka analisis yang memiliki kumpulan data asli dengan ekspresi SQL `Select all` khusus dan kumpulan data kedua yang mencakup semua nilai yang mungkin dari kolom yang difilter yang ada di kumpulan data asli.
1. Arahkan ke kumpulan data sekunder yang dibuat sebelumnya untuk mengembalikan semua nilai kolom yang difilter. Tambahkan ekspresi SQL kustom yang menambahkan `Select all` opsi yang telah dikonfigurasi sebelumnya ke kueri. Contoh berikut menambahkan ` All States` catatan ke bagian atas daftar nilai yang dikembalikan dari dataset:
```
(Select ' All States' as origin_state_abr)
Union All
(SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc)
```
1. Kembali ke analisis yang dimiliki kumpulan data dan petakan parameter kumpulan data yang Anda gunakan ke parameter analisis yang Anda buat pada langkah 3 dari prosedur sebelumnya. Parameter analisis dan parameter dataset dapat memiliki nama yang sama. Dalam contoh kita, parameter analisis disebut`States`.
1. Buat kontrol filter baru atau edit kontrol filter yang ada dan **pilih Sembunyikan Pilih Semua** untuk menyembunyikan opsi **Pilih Semua** yang dinonaktifkan yang muncul di kontrol multivalue.
Setelah Anda membuat kontrol, pengguna dapat menggunakan kontrol yang sama untuk memilih semua atau beberapa nilai kolom yang difilter dalam kumpulan data.