Halaman ini memberikan ringkasan parameter LookML yang memengaruhi saran filter. Halaman ini mencantumkan setiap parameter dengan link ke halaman referensi lengkapnya, deskripsi singkat tentang fungsinya, dan gambar tentang fungsinya.
Perilaku default
Secara default, di Tampilan atau Jelajah, saat pengguna memasukkan nilai filter untuk dimensi type: string
, Looker akan menyarankan opsi yang cocok dengan apa yang dimasukkan pengguna. Di dasbor, jika filter dasbor memfilter kolom type: string
, Looker juga akan menyarankan opsi filter. Saran filter ini dibuat menggunakan kueri SELECT DISTINCT pada dimensi, sehingga saran hanya akan menampilkan nilai yang cocok dengan data yang ada untuk kolom tersebut:
Jika Anda mengalami perilaku yang tidak terduga dan perlu memecahkan masalah saran filter, lihat halaman Praktik Terbaik Memecahkan masalah saran filter umum.
Mengaktifkan atau menonaktifkan saran filter
Bagian ini menjelaskan parameter LookML berikut yang memungkinkan Anda mengaktifkan atau menonaktifkan saran filter:
suggestable
(kolom)
Menyetel suggestable
ke no
memungkinkan Anda menonaktifkan saran untuk dimensi atau filter. Nilai default suggestable
adalah yes
, jadi Looker akan memberikan saran kepada pengguna jika memungkinkan. Jika Anda menetapkan suggestable
ke no
, Looker tidak akan memberikan saran.
suggestions
(tampilan)
Menyetel suggestions
ke no
memungkinkan Anda menonaktifkan saran untuk semua dimensi dalam tampilan. Nilai default suggestions
adalah yes
, jadi Looker akan memberikan saran kepada pengguna jika memungkinkan. Jika Anda menetapkan suggestions
ke no
, Looker tidak akan memberikan saran.
Filter nilai saran
Bagian ini menjelaskan parameter LookML berikut yang memungkinkan Anda menetapkan atau membatasi nilai yang ditampilkan di saran filter:
allowed_value
(Kolom)bypass_suggest_restrictions
(kolom)case
(kolom)full_suggestions
(kolom)suggest_dimension
(kolom) dansuggest_explore
(kolom)suggestions
(kolom)
allowed_value
(kolom)
allowed_value
berfungsi dengan parameter LookML parameter
. Jika developer Looker menyediakan kolom khusus filter parameter
, nilai yang dimasukkan atau dipilih oleh pengguna dapat direferensikan menggunakan {% parameter %} variabel Liquid. Atau, Anda dapat menggunakan allowed_value
untuk menentukan daftar nilai yang dapat dipilih pengguna untuk kolom parameter tersebut.
allowed_value
memiliki dua subparameter, label
dan value
. Subparameter label
menentukan opsi yang akan dilihat pengguna di saran filter. Subparameter value
berisi nilai yang diteruskan ke variabel Liquid {% parameter %}
.
Misalnya, parameter dapat ditentukan sebagai berikut:
parameter: order_amount {
type: string
allowed_value: {
label: "Less than $50"
value:"< 50"
}
allowed_value: {
label: "Between $50 and $100"
value:"<= 100"
}
allowed_value: {
label: "Over $100"
value:"> 100"
}
}
Kemudian, saat pengguna memfilter parameter, mereka dapat memilih dari opsi Kurang dari Rp500.000, Antara Rp500.000 dan Rp1.000.000, dan Lebih dari Rp1.000.000.
Untuk informasi selengkapnya, lihat bagian ini di halaman referensi parameter
.
bypass_suggest_restrictions
(kolom)
bypass_suggest_restrictions
mengaktifkan saran filter dalam situasi saat saran tersebut dinonaktifkan atau dibatasi. Jika Anda telah menggunakan sql_always_where
atau access_filter
untuk membatasi baris yang dapat dilihat pengguna, Looker juga akan membatasi saran filter pada nilai dalam baris yang diizinkan. Namun, jika Anda yakin bahwa tidak ada kemungkinan nilai dalam kolom dimensi atau filter tertentu yang akan mengungkapkan informasi sensitif, Anda dapat menggunakan bypass_suggest_restrictions
untuk mengaktifkan kembali kumpulan lengkap saran filter.
case
(kolom)
case
memungkinkan Anda mengelompokkan hasil dimensi dengan logika kasus. Hal ini memengaruhi saran filter karena hanya nilai yang ditentukan dalam pernyataan case
yang ditampilkan sebagai saran filter untuk dimensi tersebut.
Saran yang ditampilkan kepada pengguna untuk dimensi menggunakan
case
tidak akan dibatasi saat menggunakanfull_suggestions
. Setiap opsi yang Anda sertakan dalam parametercase
akan terlihat oleh semua pengguna.
Dimensi yang menggunakan case
dapat digunakan dengan filter tertaut, jika dimensi tersebut digunakan di filter yang memperbarui filter lainnya. Dimensi yang menggunakan case
tidak dapat digunakan di filter yang sedang diperbarui.
full_suggestions
(kolom)
Jika full_suggestions
ditetapkan ke no
, saran filter untuk dimensi akan dinonaktifkan.
Saran yang ditampilkan kepada pengguna untuk dimensi menggunakan
case
tidak akan dibatasi saat menggunakanfull_suggestions
. Setiap opsi yang Anda sertakan dalam parametercase
akan terlihat oleh semua pengguna.
suggest_dimension
(kolom) dan suggest_explore
(kolom)
Looker biasanya menghasilkan saran filter dengan menjalankan kueri SELECT DISTINCT di kolom filter. Untuk beberapa tabel besar, kueri ini bisa terlalu lambat atau membuat pemuatan database yang terlalu besar. Anda dapat menggunakan suggest_dimension
untuk membuat kueri Looker sebagai dimensi alternatif untuk saran filter, dikombinasikan dengan suggest_explore
jika dimensi tersebut berada di Jelajah yang berbeda.
suggestions
(kolom)
suggestions
memungkinkan Anda melakukan hard code pada daftar kemungkinan nilai saran filter. Hal ini dapat berguna jika Anda tidak ingin nilai data tertentu dalam kolom muncul sebagai saran, dan sebagai gantinya ingin menentukan daftar yang lebih terbatas.
Menyimpan saran filter ke cache
Bagian ini menjelaskan parameter suggest_persist_for
, yang memungkinkan Anda mengonfigurasi durasi waktu saran filter di-cache.
Jika Anda ingin mengurangi beban pada database dan jumlah nilai data untuk dimensi yang sangat tinggi, sebaiknya gunakan parameter untuk menonaktifkan saran filter untuk dimensi Anda. Jika Anda ingin saran filter muncul, sebaiknya gunakan parameter untuk membatasi nilai filter yang dikueri atau melakukan hard code opsi yang sesuai.
suggest_persist_for
(kolom)
Secara default, saran filter disimpan di cache selama 6 jam, sehingga menghasilkan daftar saran yang sama untuk durasi tersebut. Parameter suggest_persist_for
memungkinkan Anda mengubah berapa lama saran filter disimpan di cache.