Parameter memungkinkan Anda membuat laporan yang lebih responsif dan dapat disesuaikan. Anda dapat meneruskan parameter dalam sumber data ke kueri pokok. Untuk menggunakan parameter dalam kueri kustom, ikuti panduan sintaksis relevan yang didokumentasikan di bagian Menjalankan kueri berparameter
Parameter standar
Anda dapat menggunakan parameter berikut di kueri kustom:
|
Parameter |
Tujuan |
|---|---|
|
@DS_START_DATE |
Mendapatkan awal rentang tanggal laporan. |
|
@DS_END_DATE |
Mendapatkan akhir rentang tanggal laporan. |
|
@DS_USER_EMAIL |
Mendapatkan alamat email pengguna yang login. |
Cara menggunakan parameter ini:
-
Di bawah editor kueri, aktifkan parameter yang ingin digunakan.
Anda akan diminta untuk memberikan akses ke alamat email saat mengaktifkan parameter @DS_USER_EMAIL. -
Dalam kueri, pastikan Anda menggunakan huruf besar untuk nama parameter.
Semua nilai parameter akan diteruskan sebagai string. Untuk menanganinya sebagai tanggal, angka, atau jenis data lainnya, pastikan Anda menggunakan fungsi konversi yang sesuai, seperti PARSE_DATE, PARSE_TIMESTAMP, atau CAST.
Gunakan parameter tanggal untuk meneruskan rentang tanggal ke kueri pokok
Jika laporan Anda menyertakan kontrol rentang tanggal, pelihat dapat menggunakannya untuk meminta tanggal mulai dan akhir yang berbeda dari data.
Gunakan parameter email untuk memberikan akses tingkat baris ke data
Parameter email memungkinkan Anda hanya menampilkan data terkait pengguna laporan, sumber data, atau eksplorasi yang login. Pengguna tersebut harus login ke akun Google dan harus memberikan alamat email ke Looker Studio. Jika pelihat tidak memberikan izin, semua diagram dalam laporan berdasarkan sumber data ini akan menampilkan error otorisasi.
Parameter kustom
Dalam kueri kustom, Anda dapat menggunakan parameter apa pun yang dibuat di antarmuka pengguna Looker Studio.
Membuat parameter di halaman koneksi
- Di bawah editor kueri kustom, klik +TAMBAHKAN PARAMETER.
- Konfigurasikan opsi parameter.
- Klik OKE.
Menyembunyikan parameter kustom di sumber data
Secara default, parameter kustom dapat diubah dalam laporan. Untuk mencegah pengedit laporan mengubah nilai parameter, Anda dapat menyembunyikan parameter.
- Di sebelah kanan parameter, klik Opsi lainnya
.
- Klik Sembunyikan.
.Pelajari lebih lanjut cara mengizinkan parameter sumber data dalam laporan.
Menggunakan parameter dalam kueri kustom
Dalam isi kueri kustom, ganti nilai hard code dengan ID yang diawali dengan karakter @. Misalnya: @param_name.
Contoh parameter
Contoh parameter kustom:
SELECT word FROM `TABLE` WHERE corpus = @corpus;
Gunakan string dengan fungsi 'contains' dan sebuah angka:
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
Gunakan parameter string multi-pilihan. Perhatikan penggunaan UNNEST untuk meratakan daftar nilai:
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
Contoh parameter tanggal (tanggal dalam format standar):
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);
Contoh parameter tanggal (tanggal adalah stempel waktu Unix dalam mikrodetik):
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE))
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE));
Contoh parameter email:
Select * from Sales WHERE sales-rep-email = @DS_USER_EMAIL;