Halaman ini memberikan ringkasan parameter LookML yang memengaruhi saran filter. Halaman ini mencantumkan setiap parameter dengan link ke halaman referensi lengkapnya dan deskripsi singkat tentang fungsinya.
Perilaku default
Secara default, di Look atau Eksplorasi, saat pengguna memasukkan nilai filter untuk kolom yang mendukung saran, Looker akan menyarankan opsi yang cocok dengan yang dimasukkan pengguna. Di dasbor, jika filter dasbor memfilter kolom yang mendukung saran, Looker juga menyarankan opsi filter. Saran filter ini dibuat menggunakan kueri SELECT DISTINCT pada kolom, 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 umum terkait saran filter.
Jenis kolom yang mendukung saran
Looker mendukung saran untuk nilai type
berikut untuk kolom dimension
, dimension_group
, filter
, danparameter
.
Nilai dimensi type
yang mendukung saran:
Nilai grup dimensi type
yang mendukung saran:
type: time
, dengan nilaitimeframes
berikut:
Nilai type
filter yang mendukung saran:
type: string
Nilai parameter type
yang mendukung saran:
type: string
type: unquoted
Mengaktifkan atau menonaktifkan saran filter
Bagian ini menjelaskan parameter LookML berikut yang memungkinkan Anda mengaktifkan atau menonaktifkan saran filter:
suggestions
(lihat)
Secara default, saat pengguna memfilter Eksplorasi pada kolom yang mendukung saran, Looker akan menyarankan kemungkinan nilai untuk kolom tersebut.
Anda dapat menentukan tampilan dengan suggestions:no
untuk menonaktifkan saran untuk semua kolom dalam tampilan.
suggestable
(kolom)
Secara default, saat pengguna memfilter Eksplorasi pada kolom yang mendukung saran, Looker akan menyarankan kemungkinan nilai untuk kolom tersebut.
Anda dapat menentukan kolom individual dengan suggestable:no
untuk menonaktifkan saran untuk kolom tersebut.
Nilai saran filter
Bagian ini menjelaskan parameter LookML berikut yang memungkinkan Anda menetapkan atau membatasi nilai yang ditampilkan dalam 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 hanya filter parameter
, nilai yang dimasukkan atau dipilih oleh pengguna dapat dirujuk menggunakan variabel Liquid {% parameter %}. Secara opsional, 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 dalam 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 mengetahui informasi selengkapnya, lihat bagian ini di halaman referensi parameter
.
bypass_suggest_restrictions
(kolom)
bypass_suggest_restrictions
mengaktifkan saran filter dalam situasi yang seharusnya 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 ke nilai dalam baris yang diizinkan. Namun, jika Anda yakin bahwa tidak ada kemungkinan nilai dalam kolom tertentu yang akan mengungkapkan informasi sensitif, Anda dapat menggunakan bypass_suggest_restrictions
untuk memulihkan set 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.
Dimensi yang menggunakan case
dapat digunakan dengan filter tertaut, jika dimensi digunakan dalam filter yang memperbarui filter lainnya. Dimensi yang menggunakan case
tidak dapat digunakan dalam filter yang sedang diperbarui.
full_suggestions
(kolom)
Anda dapat menentukan kolom dengan parameter full_suggestions
untuk mengontrol cara Looker membuat kueri database Anda guna memberikan saran untuk nilai kolom bagi filter:
full_suggestions: no
: Looker akan menggunakan kueri dasar nilai unik, dan hanya akan membuat kueri tampilan yang berisi kolom filter.full_suggestions: yes
: Looker akan menambahkan logika Jelajah ke kueri saran filternya, yang berarti Looker akan menyertakan gabungan Jelajah yang diperlukan untuk mengkueri kolom filter, dan Looker akan menyertakan logika dari parameter Jelajah, sepertisql_always_where
,access_filter
, danconditionally_filter
.
Lihat halaman full_suggestions
untuk mengetahui informasi tentang perilaku default Looker dalam memberikan saran dan pertimbangan untuk Eksplorasi dengan sql_always_where
atau access_filter
suggest_dimension
(kolom) dan suggest_explore
(kolom)
Looker biasanya membuat saran filter dengan menjalankan kueri SELECT DISTINCT pada kolom filter. Untuk beberapa tabel besar, kueri ini bisa terlalu lambat atau membuat beban database terlalu besar. Anda dapat menggunakan suggest_dimension
untuk membuat Looker mengkueri dimensi alternatif untuk saran filter, bersama dengan suggest_explore
jika dimensi tersebut berada di Eksplorasi yang berbeda.
suggestions
(kolom)
suggestions
memungkinkan Anda meng-hardcode daftar kemungkinan nilai saran filter. Tindakan ini dapat berguna jika Anda tidak ingin nilai data tertentu dalam kolom muncul sebagai saran, dan ingin menentukan daftar yang lebih terbatas.
Menyimpan saran filter dalam cache
Bagian ini menjelaskan parameter suggest_persist_for
, yang memungkinkan Anda mengonfigurasi jangka waktu saran filter di-cache.
Jika Anda ingin mengurangi beban pada database dan jumlah nilai data untuk suatu kolom sangat tinggi, pertimbangkan untuk menggunakan parameter guna menonaktifkan saran filter untuk kolom Anda. Jika Anda ingin saran filter muncul, pertimbangkan untuk menggunakan parameter guna membatasi nilai filter yang dikueri atau untuk meng-hardcode opsi yang sesuai.
suggest_persist_for
(kolom)
Secara default, saran filter di-cache selama enam jam, sehingga menghasilkan daftar saran yang sama selama jangka waktu tersebut. Parameter suggest_persist_for
memungkinkan Anda mengubah durasi saran filter di-cache.