always_filter

Penggunaan

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}

Hierarki File Model explore always_filter

Nilai Default Tidak ada Menerima Nama kolom dan ekspresi filter Looker

Definisi

Parameter always_filter memungkinkan Anda mewajibkan pengguna menyertakan serangkaian filter untuk Eksplorasi. Setelah Anda menentukan filter dan nilai defaultnya menggunakan parameter always_filter, Explore akan otomatis menampilkan setelan filter yang Anda konfigurasi.

Filter yang Anda tentukan dalam parameter always_filter tidak dapat dihapus dari Eksplorasi. Namun, pengguna Anda dapat mengubah filter dengan mengubah nilai filter atau dengan mengubah kondisi filter dari menu drop-down kondisi. Pengguna Anda juga dapat menghapus semua nilai dari filter, yang memiliki efek yang sama dengan menghapus filter.

Jika Anda ingin Explore memiliki filter yang tidak dapat diubah atau dihapus, gunakan salah satu parameter berikut:

• Untuk mengonfigurasi filter yang sama untuk semua orang dan yang tidak dapat dilihat atau diubah dengan cara apa pun, Anda dapat menggunakan sql_always_where.
• Untuk mengonfigurasi filter yang khusus untuk setiap pengguna dan tidak dapat dilihat atau diubah dengan cara apa pun, Anda dapat menggunakan access_filter.

Dalam parameter always_filter, kolom yang dirujuk dalam subparameter filters dapat berupa dimensi, pengukuran, filter, atau parameter. Jika Anda perlu mereferensikan dimensi atau ukuran yang merupakan bagian dari gabungan tampilan, bukan bagian dari Eksplorasi ini, gunakan view_name.field_name. Contoh:

explore: order {
  always_filter: {
    filters: [id: "123", customer.id: "789"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Di sini, filter id merujuk pada kolom id dari order. Filter customer.id merujuk ke kolom id dari customer. Contoh ini juga menunjukkan bahwa Anda dapat menambahkan beberapa filter.

Untuk setiap pasangan field_name: "filter expression", ekspresi filter dapat berupa nilai absolut atau Anda dapat menggunakan ekspresi filter Looker, bergantung pada jenis kolom yang Anda filter.

Contoh

Konfigurasi filter default untuk Eksplorasi di kolom ID Pesanan (dengan nilai default "123"):

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

Konfigurasi filter default untuk Explore pada kolom Tanggal Pembuatan Pesanan (dengan nilai default tujuh hari sebelumnya):

explore: order {
  always_filter: {
    filters: [created_date: "7 days"]
  }
}

Konfigurasi filter default untuk Eksplorasi di kolom ID Pesanan (nilai default "123"), kolom Kota Pesanan (nilai default "Chicago"), dan kolom Usia Pelanggan (nilai default lebih besar dari atau sama dengan 18):

explore: order {
  always_filter: {
    filters: [id: "123", city: "Chicago", customer.age: ">=18"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Hal-hal yang perlu dipertimbangkan

Pengguna tidak dapat menghapus filter yang ditentukan oleh always_filter

Meskipun dapat mengubah kondisi atau nilai default untuk kueri, pengguna tidak dapat menghapus filter yang telah ditambahkan oleh always_filter. Jika Anda ingin memuat filter terlebih dahulu untuk Eksplorasi dengan cara yang memungkinkan pengguna menghapus filter sepenuhnya, pertimbangkan untuk membuat kueri yang menyertakan filter yang disarankan, lalu membagikan kueri kepada pengguna agar mereka dapat menggunakan kueri dan filternya sebagai titik awal.

Menetapkan nilai default kosong

Jika ingin membuat filter default dengan nilai default kosong, Anda dapat melakukannya dengan menentukan "-EMPTY" dalam nilai filter:

always_filter: {
  filters: [products.category: "-EMPTY"]
}

Parameter always_filter menggantikan setelan filter default_value

Parameter always_filter menggantikan setelan default_value untuk kolom. Jika Anda mendeklarasikan nilai dengan always_filter, nilai tersebut akan menjadi default di Jelajah. Jika Anda tidak mendeklarasikan nilai dengan always_filter, "adalah nilai apa pun" akan menjadi default filter di Eksplorasi.

always_filter memengaruhi Look dan kartu dasbor yang ada

Menambahkan parameter always_filter ke definisi explore yang ada akan menambahkan kumpulan filter dengan nilai default ke semua Look, Eksplorasi, atau kartu dasbor yang didasarkan pada explore tersebut, termasuk Look dan kartu dasbor yang sebelumnya disimpan dan didasarkan pada explore.