full_suggestions

Penggunaan

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
Hierarki
view
Jenis Kolom
full_suggestions
Jenis Kolom yang Mungkin
Dimensi, Grup Dimensi, Filter, Parameter

Menerima
Boolean (ya atau tidak)

Definisi

Saat pengguna memfilter Eksplorasi pada jenis kolom yang mendukung saran, secara default Looker akan menyarankan kemungkinan nilai untuk kolom (lihat halaman dokumentasi Mengubah saran filter untuk mengetahui informasi tentang cara Anda dapat memengaruhi saran filter). Untuk memberikan saran untuk kolom filter, Looker menjalankan kueri di database Anda untuk mengambil daftar nilai unik untuk kolom tersebut. Looker biasanya menghasilkan saran ini dengan menjalankan kueri seperti berikut pada kolom filter:

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

Parameter full_suggestions mengontrol cara Looker membuat kueri database Anda untuk memberikan saran nilai kolom dalam filter Eksplorasi:

  • full_suggestions: no: Looker akan menggunakan kueri saran filter umum, 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, termasuk parameter berikut:

Perilaku default

Jika parameter full_suggestions tidak ditentukan untuk kolom, Looker akan membuat kueri untuk nilai saran dengan perilaku berikut:

  • Untuk Eksplorasi yang menggunakan sql_always_where atau access_filter, atau always_join, Looker secara default menggunakan perilaku full_suggestions: yes. Karena parameter access_filter, sql_always_where, dan always_join menerapkan batasan pada kueri Jelajah, batasan yang sama ini diterapkan pada kueri saran filter. Lihat Pertimbangan untuk Eksplorasi dengan sql_always_where atau access_filter untuk mengetahui informasi tambahan tentang cara Looker memberikan saran untuk Eksplorasi dengan batasan kueri.
  • Jika tidak, Looker akan menggunakan perilaku full_suggestions: no secara default, mengkueri hanya tampilan kolom filter, dan tanpa menyertakan logika Jelajah apa pun. Setelan full_suggestions: no membuat saran filter berperforma lebih baik, karena Looker mengkueri satu tabel tanpa gabungan, tanpa menggunakan logika apa pun yang ditentukan di Jelajah.

Contoh

Untuk meminta Looker menggunakan logika Eksplorasi untuk membuat kueri database Anda saat memberikan saran filter untuk dimensi, tambahkan full_suggestions: yes ke definisi dimensi:

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

Pertimbangan untuk Eksplorasi dengan sql_always_where atau access_filter

Parameter sql_always_where dan access_filter sering digunakan untuk mengontrol akses data. Setiap kali sql_always_where atau access_filter digunakan pada Eksplorasi, Looker akan menerapkan batasan tersebut pada saran filter yang dibuatnya untuk jenis kolom yang mendukung saran. Untuk mencegah pengguna melihat saran filter yang tidak berlaku bagi mereka, Looker mewajibkan agar logika Jelajah (full_suggestions:yes) diterapkan pada saran nilai filter di Jelajah. Oleh karena itu, jika Eksplorasi ditentukan dengan sql_always_where atau access_filter, Looker tidak akan memberikan saran apa pun untuk filter pada kolom yang ditentukan dengan full_suggestions:no.

Jika Anda memiliki Eksplorasi dengan sql_always_where atau access_filter, dan Anda memiliki kolom yang Anda ketahui tidak memerlukan logika sql_always_where atau access_filter, Anda dapat mengganti perilaku dengan menambahkan bypass_suggest_restrictions:yes ke definisi kolom. Pernyataan bypass_suggest_restrictions:yes meminta Looker untuk memberikan daftar lengkap saran nilai filter.