full_suggestions

Penggunaan

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

Menerima
Boolean (ya atau tidak)

Definisi

Saat pengguna memfilter Jelajah pada jenis kolom yang mendukung saran, Looker akan menyarankan kemungkinan nilai untuk kolom tersebut secara default (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 pada database Anda untuk mengambil daftar nilai unik untuk kolom tersebut. Looker biasanya membuat 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 mengkueri database Anda untuk memberikan saran untuk nilai kolom dalam filter Jelajah:

  • full_suggestions: no: Looker akan menggunakan kueri saran filter biasanya, 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 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 mengkueri nilai saran dengan perilaku berikut:

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

Contoh

Untuk meminta Looker menggunakan logika Jelajah untuk mengkueri 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 Jelajah 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 di Jelajah, Looker akan menerapkan batasan tersebut ke saran filter yang dibuatnya untuk jenis kolom yang mendukung saran. Untuk mencegah pengguna melihat saran filter yang tidak berlaku untuk mereka, Looker mengharuskan logika Jelajah (full_suggestions:yes) diterapkan ke saran nilai filter di Jelajah. Oleh karena itu, jika Jelajah ditentukan dengan sql_always_where atau access_filter, Looker tidak akan memberikan saran untuk filter pada kolom yang ditentukan dengan full_suggestions:no.

Jika Anda memiliki Jelajah 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 tersebut dengan menambahkan bypass_suggest_restrictions:yes ke definisi kolom. Pernyataan bypass_suggest_restrictions:yes meminta Looker untuk memberikan daftar lengkap saran nilai filter.