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 untuk menyertakan serangkaian filter untuk Explore. 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 Explore. Namun, pengguna dapat mengubah filter dengan mengubah nilai filter atau dengan mengubah kondisi filter dari menu drop-down kondisi. Pengguna 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 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, ukuran, filter, atau parameter. Jika Anda perlu merujuk dimensi atau ukuran yang merupakan bagian dari tampilan gabungan, bukan bagian dari Explore 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 ke 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

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

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

Mengonfigurasi filter default untuk Explore di kolom Order Created Date (dengan nilai default tujuh hari sebelumnya):

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

Mengonfigurasi filter default untuk Eksplorasi di kolom ID Pesanan (nilai default "123"), kolom Order City (nilai default "Chicago"), dan kolom Customer Age (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 pengguna dapat mengubah kondisi atau nilai default untuk kueri mereka, mereka tidak dapat menghapus filter yang telah ditambahkan oleh always_filter. Jika Anda ingin memuat filter untuk Explore dengan cara yang memungkinkan pengguna menghapus filter sepenuhnya, pertimbangkan untuk membuat kueri yang menyertakan filter yang disarankan, lalu bagikan kueri kepada pengguna sehingga 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 mengganti setelan filter default_value

Parameter always_filter mengganti setelan default_value untuk kolom. Jika Anda mendeklarasikan nilai dengan always_filter, nilai tersebut akan menjadi default di Explore. Jika Anda tidak mendeklarasikan nilai dengan always_filter, "is any value" akan menjadi default filter di Explore.

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 Look, Explore, atau kartu dasbor yang didasarkan pada explore tersebut, termasuk Look dan kartu dasbor yang sebelumnya disimpan dan didasarkan pada explore.