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 Jelajah, 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 akan 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 type
dimensi yang mendukung saran:
Nilai type
grup dimensi yang mendukung saran:
type: time
, dengan nilaitimeframes
berikut:
Filter nilai type
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
(tampilan)
Secara default, saat pengguna memfilter Jelajah di 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 Jelajah di kolom yang mendukung saran, Looker akan menyarankan kemungkinan nilai untuk kolom tersebut.
Anda dapat menentukan setiap kolom 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 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 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 berdasarkan parameter, mereka dapat memilih dari opsi Kurang dari $50, Antara $50 dan $100, dan Lebih dari $100.
Untuk informasi selengkapnya, lihat bagian ini di halaman referensi parameter
.
bypass_suggest_restrictions
(kolom)
bypass_suggest_restrictions
mengaktifkan saran filter dalam situasi yang seharusnya menonaktifkan atau membatasi saran filter. 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 di kolom 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.
Dimensi yang menggunakan case
dapat digunakan dengan filter tertaut, jika dimensi tersebut 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 filter:
full_suggestions: no
: Looker akan menggunakan kueri dasar dari nilai yang berbeda, dan hanya akan mengkueri tampilan yang berisi kolom filter.full_suggestions: yes
: Looker akan menambahkan logika Jelajah ke kueri saran filternya, yang berarti Looker akan menyertakan join Jelajah yang diperlukan untuk membuat kueri 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 untuk memberikan saran dan pertimbangan untuk Jelajah 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 dapat terlalu lambat atau membuat beban database terlalu besar. Anda dapat menggunakan suggest_dimension
untuk membuat Looker membuat kueri dimensi alternatif untuk saran filter, yang 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 di 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 durasi penyimpanan saran filter dalam cache.
Jika Anda ingin mengurangi beban pada database dan jumlah nilai data untuk 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 melakukan hard code pada opsi yang sesuai.
suggest_persist_for
(kolom)
Secara default, saran filter disimpan ke cache selama enam jam, sehingga menghasilkan daftar saran yang sama selama jangka waktu tersebut. Parameter suggest_persist_for
memungkinkan Anda mengubah durasi penyimpanan saran filter dalam cache.