Menggunakan parameter dalam kueri kustom

Parameter memungkinkan Anda membuat laporan responsif dan dapat disesuaikan dengan meneruskan parameter dari sumber data kembali ke kueri SQL pokok. Untuk menggunakan parameter di dalam kueri kustom, ikuti panduan sintaksis 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.

Untuk menggunakan parameter ini, ikuti langkah-langkah berikut:

  1. Di bagian Parameters pada panel koneksi, aktifkan parameter yang ingin Anda gunakan. Data Studio akan meminta Anda untuk memberikan akses ke alamat email Anda saat Anda mengaktifkan parameter @DS_USER_EMAIL.
  2. Dalam kueri, gunakan format huruf besar saat mengetik nama parameter.

Data Studio meneruskan semua nilai parameter sebagai string teks. Untuk menangani string parameter sebagai tanggal kalender, angka, atau jenis data lainnya, gunakan fungsi konversi SQL yang sesuai, seperti PARSE_DATE, PARSE_TIMESTAMP, atau CAST.

Menggunakan parameter tanggal untuk meneruskan rentang tanggal ke kueri pokok

Jika laporan Anda menyertakan kontrol rentang tanggal tanggal, pelihat dapat menggunakan kontrol tersebut untuk meminta tanggal mulai dan akhir yang berbeda langsung dari database.

Menggunakan parameter email untuk memberikan akses tingkat baris ke data

Parameter email memungkinkan Anda hanya menampilkan data yang terkait dengan pengguna laporan, sumber data, atau eksplorasi yang login. Pengguna tersebut harus login ke Akun Google dan harus mengizinkan pemberian alamat email ke Data Studio. Jika pelihat tidak memberikan izin, semua diagram dalam laporan yang didasarkan pada sumber data ini akan menampilkan error otorisasi.

Parameter kustom

Dalam kueri kustom, Anda dapat menggunakan parameter apa pun yang dibuat di antarmuka pengguna Data Studio.

Membuat parameter di halaman koneksi

  1. Di bagian Parameters pada editor kueri kustom, klik +ADD PARAMETER.
  2. Konfigurasi opsi parameter.
  3. Klik OK.

Menyembunyikan parameter kustom di sumber data

Secara default, pengedit laporan dapat mengubah parameter kustom langsung di dalam laporan. Untuk mencegah pengedit laporan mengubah nilai parameter, Anda dapat menyembunyikan parameter langsung di konfigurasi sumber data:

  1. Klik Opsi lainnya.
  2. Klik Hide.

Pelajari lebih lanjut cara mengizinkan parameter sumber data dalam laporan.

Menggunakan parameter dalam kueri kustom

Dalam isi kueri SQL kustom, ganti nilai hard code dengan ID yang diawali dengan karakter @ (misalnya, @param_name).

Contoh parameter

Berikut beberapa contoh penggunaan parameter:

Contoh parameter kustom

SELECT word FROM `TABLE` WHERE corpus = @corpus;

String dengan CONTAINS dan nilai minimum numerik

SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;

Parameter string multi-pilihan

Perhatikan cara UNNEST meratakan daftar array nilai parameter multi-pilihan:

SELECT * from user.users as user WHERE display_name in UNNEST(@name);

Parameter tanggal menggunakan 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);

Parameter tanggal menggunakan stempel waktu Unix dalam mikrodetik

SELECT creation_date, age, display_name from user.users as use
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;