always_filter

Utilizzo

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

Gerarchia File del modello explore always_filter

Valore predefinito Nessuno Accetta Un nome campo e un'espressione di filtro di Looker

Definizione

Il parametro always_filter consente di richiedere agli utenti di includere un insieme di filtri per un Explore. Dopo aver definito i filtri e i relativi valori predefiniti utilizzando il parametro always_filter, Esplora visualizza automaticamente le impostazioni dei filtri configurate.

I filtri specificati nel parametro always_filter non possono essere rimossi dall'esplorazione. Tuttavia, gli utenti possono modificare il filtro cambiando i valori o la condizione dal menu a discesa delle condizioni. Gli utenti possono anche rimuovere tutti i valori dal filtro, il che ha lo stesso effetto della rimozione del filtro.

Se vuoi che un'esplorazione abbia filtri che non possono essere modificati o rimossi, utilizza uno dei seguenti parametri:

• Per configurare filtri uguali per tutti e che non possono essere visualizzati o modificati in alcun modo, puoi utilizzare sql_always_where.
• Per configurare filtri specifici per ogni utente e che non possono essere visualizzati o modificati in alcun modo, puoi utilizzare access_filter.

Nel parametro always_filter, il campo a cui viene fatto riferimento nel parametro secondario filters può essere una dimensione, una misura, un filtro o un parametro. Se devi fare riferimento a una dimensione o a una misura che fa parte di una visualizzazione unita anziché di questa esplorazione, utilizza view_name.field_name. Ad esempio:

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

In questo caso, il filtro id si riferisce al campo id di order. Il filtro customer.id fa riferimento al campo id di customer. Questo esempio mostra anche che puoi aggiungere più filtri.

Per ogni coppia field_name: "filter expression", l'espressione di filtro può essere un valore assoluto oppure puoi utilizzare le espressioni di filtro di Looker, a seconda del tipo di campo su cui stai applicando il filtro.

Esempi

Configura un filtro predefinito per l'esplorazione nel campo ID ordine (con un valore predefinito di "123"):

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

Configura un filtro predefinito per l'esplorazione nel campo Data creazione ordine (con un valore predefinito di sette giorni precedenti):

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

Configura un filtro predefinito per l'esplorazione nei campi ID ordine (valore predefinito "123"), Città ordine (valore predefinito "Chicago") e Età cliente (valore predefinito maggiore o uguale a 18):

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

Aspetti da considerare

Gli utenti non possono rimuovere un filtro specificato da always_filter

Sebbene gli utenti possano modificare la condizione o il valore predefinito della query, non possono rimuovere un filtro aggiunto da always_filter. Se vuoi precaricare i filtri per un'esplorazione in modo che gli utenti possano rimuoverli completamente, valuta la possibilità di creare una query che includa i filtri suggeriti e poi condividere la query con gli utenti in modo che possano utilizzarla e i relativi filtri come punto di partenza.

Impostazione di un valore predefinito vuoto

Se vuoi creare un filtro predefinito con un valore predefinito vuoto, puoi farlo specificando "-EMPTY" nei valori del filtro:

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

Il parametro always_filter esegue l'override di un'impostazione del filtro default_value

Il parametro always_filter sostituisce l'impostazione default_value per il campo. Se dichiari un valore con always_filter, questo sarà il valore predefinito nell'esplorazione. Se non dichiari un valore con always_filter, "è qualsiasi valore" è il filtro predefinito in Esplora.

always_filter influisce sui Look e sui riquadri delle dashboard esistenti

L'aggiunta del parametro always_filter a una definizione explore esistente aggiunge il set di filtri con i valori predefiniti a tutti i Look, le esplorazioni o i riquadri della dashboard basati su explore, inclusi i Look e i riquadri della dashboard salvati in precedenza basati su explore.