always_filter

Utilizzo

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

Gerarchia File modello explore always_filter

Valore predefinito Nessuno Accetta Un nome di 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'esplorazione. Dopo aver definito i filtri e i relativi valori predefiniti utilizzando il parametro always_filter, l'esplorazione 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 del filtro o la condizione del filtro 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 sottoparametro 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 vista 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} ;;
  }
}

Qui il filtro id si riferisce al campo id di order. Il filtro customer.id si riferisce 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 filtrando.

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 di creazione dell'ordine (con un valore predefinito degli ultimi sette giorni):

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

Configura un filtro predefinito per l'esplorazione nel campo ID ordine (valore predefinito "123"), nel campo Città dell'ordine (valore predefinito "Chicago") e nel campo Età del 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 per la 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 di condividere la query con gli utenti in modo che possano utilizzarla e i relativi filtri come punto di partenza.

Impostare 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 esegue l'override dell'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, il valore predefinito del filtro nell'esplorazione è "è qualsiasi valore".

always_filter influisce su Look e riquadri della dashboard esistenti

L'aggiunta del parametro always_filter a una definizione explore esistente aggiunge l'insieme 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.