Menggunakan parameter dalam kueri kustom

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.

Untuk menggunakan parameter ini:

  1. Di bawah editor kueri, aktifkan parameter yang ingin digunakan.

    Anda akan diminta untuk memberikan akses ke alamat email saat mengaktifkan parameter \@DS_USER_EMAIL.

  2. 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

  1. Di bawah editor kueri kustom, klik +TAMBAHKAN PARAMETER.
  2. Konfigurasikan opsi parameter.
  3. 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.

  1. Di sebelah kanan parameter, klik Opsi lainnya Opsi lainnya. .
  2. 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;

Tentang parameter