Espressioni di filtro di Looker

Le espressioni di filtro sono un modo avanzato per filtrare le query di Looker. Puoi utilizzare le espressioni di filtro nei seguenti modi:

• Nella sezione Esplora di Looker, puoi aggiungere un filtro, scegliere l'opzione Corrispondenze (avanzato) e poi inserire una delle espressioni elencate in questa pagina per il tipo di filtro come valore del filtro.
• Negli elementi LookML che accettano un parametro filter.

Questa pagina elenca i valori che puoi inserire per un filtro che utilizza l'opzione di condizione corrisponde (avanzata) in un'esplorazione di Looker. A seconda del tipo di filtro e dell'input per il valore del filtro, Looker potrebbe convertire l'opzione Corrispondenze (avanzato) in una condizione di filtro più appropriata.

Informazioni importanti sulle espressioni di filtro

Tieni presente le seguenti note quando utilizzi le espressioni di filtro di Looker:

• Le espressioni di filtro in questa pagina sono supportate anche per alcuni tipi di filtri in Looker Studio quando il connettore Looker fa riferimento a un'esplorazione di Looker come origine dati e il filtro utilizza una condizione Corrisponde (avanzato). La condizione Corrispondenze (avanzata) si comporta in modo leggermente diverso in Looker Studio rispetto a un'esplorazione di Looker. Looker potrebbe convertire la condizione corrispondenze (avanzata) in una condizione più appropriata, in base all'input dell'utente. Tuttavia, Looker Studio utilizza l'opzione Corrisponde (avanzato) come condizione generica quando l'input dell'utente non è appropriato per le altre condizioni di filtro supportate da Looker Studio, ma Looker Studio non converte la condizione.
• Nelle esplorazioni, i filtri di base utilizzano alcune frasi il cui significato è diverso dalle espressioni di filtro documentate in questa pagina.
• Quando utilizzi le espressioni di filtro in LookML, inserisci l'espressione tra virgolette (consulta la pagina della documentazione filters per un utilizzo corretto). Ciò è particolarmente importante per i valori logici come NULL. Quando utilizzi le espressioni di filtro nella sezione Esplora di Looker, non devi racchiuderle tra virgolette.
• Le espressioni di filtro non sono supportate con le concessioni di accesso. Per ulteriori informazioni, consulta la pagina della documentazione relativa a access_grant.

Espressioni di filtro per ogni tipo di filtro

Inserisci i seguenti esempi come valori di filtro nei filtri di esplorazione di Looker che utilizzano l'opzione di condizione Corrispondenze (avanzato). Le espressioni di filtro sono supportate per i seguenti tipi di filtri:

• Stringa
• Data e ora
• Booleano
• Numero
• Località

Stringa

Inclusione di caratteri speciali nei filtri delle stringhe

Tieni presente queste regole per l'inclusione di caratteri speciali nei filtri delle stringhe:

• Per includere ", % o _, aggiungi come prefisso il carattere di escape ^. Ad esempio: ^", ^% e ^_
• Per includere un - iniziale, esegui l'escape come ^-. Questa operazione è necessaria solo se - è il primo carattere; non è necessario eseguire l'escape di - se si trova all'interno della stringa.
• Per includere ^, esegui l'escape come ^^.
• Per includere una virgola in un filtro di stringa UI normale, aggiungi il prefisso barra rovesciata alla virgola, \. Ad esempio: Santa Cruz\, CA.
• Per includere una virgola con l'opzione Corrispondenze (avanzate) in un filtro, anteponi alla virgola il carattere di escape, ^. Ad esempio: Santa Cruz^, CA.
• Per includere una virgola in un'espressione di filtro in LookML, anteponi il carattere di escape ^. Ad esempio:

  field: filtered_count {
      type: count
      filters: [city: "Santa Cruz^, CA"]
    }

Data e ora

Il filtro delle date di Looker consente di utilizzare frasi in inglese anziché funzioni di data SQL.

Struttura di base dei filtri per data e ora

Per i seguenti esempi:

• {n} è un numero intero.

• {interval} è un incremento di tempo, ad esempio ore, giorni, settimane o mesi.

  La formulazione che utilizzi determina se il {interval} includerà periodi di tempo parziali o solo completi. Ad esempio, l'espressione 3 days include il giorno parziale corrente e i due giorni precedenti. L'espressione 3 days ago for 3 days include i tre giorni completi precedenti ed esclude il giorno corrente parziale. Per ulteriori informazioni, consulta la sezione Date relative.

• {time} può specificare un orario formattato come AAAA-MM-GG HH:MM:SS o AAAA/MM/GG HH:MM:SS oppure una data formattata come AAAA-MM-GG o AAAA/MM/GG. Quando utilizzi il formato AAAA-MM-GG, assicurati di includere entrambe le cifre per il mese e il giorno, ad esempio 2016-01. Il troncamento di un mese o di un giorno a una sola cifra viene interpretato come un offset, non come una data. Ad esempio, 2016-1 viene interpretato come 2016 meno un anno, ovvero 2015.

Queste sono tutte le combinazioni possibili di filtri per data:

I filtri per data possono anche essere combinati:

• Per ottenere la logica OR: digita più condizioni nello stesso filtro, separate da virgole. Ad esempio, today, 7 days ago significa "oggi o 7 giorni fa".
• Per ottenere la logica AND:digita le condizioni, una alla volta, in più filtri di data o ora. Ad esempio, puoi inserire after 2014-01-01 in un filtro Data creazione e before 2 days ago in un filtro Ora creazione. Ciò significherebbe "1° gennaio 2014 e dopo, e prima di 2 giorni fa".

Date assolute

I filtri per data assoluta utilizzano i valori di data specifici per generare i risultati della query. Questi sono utili quando crei query per intervalli di date specifici.

Date relative

I filtri per le date relative consentono di creare query con valori di date continuate relativi alla data corrente. Sono utili quando crei query che vengono aggiornate ogni volta che le esegui.

Per tutti gli esempi seguenti, supponi che oggi sia venerdì 18/05/2018 alle 18:30:02. In Looker, le settimane iniziano di lunedì, a meno che tu non modifichi questa impostazione con week_start_day.

Secondi

Minuti

Ore

Giorni

Settimane

Mesi

Trimestri

Anni

Booleano

Il filtro in base ai valori di tipo vero o falso in Looker richiede di sapere con quale tipo di valore vero o falso stai interagendo.

Numero

I filtri sui numeri supportano sia le espressioni in linguaggio naturale (ad esempio, 3 to 10) sia gli operatori relazionali (ad esempio, >20). Looker supporta l'operatore OR per esprimere più intervalli di filtri (ad esempio, 3 to 10 OR 30 to 100). L'operatore AND può essere utilizzato per esprimere intervalli numerici con operatori relazionali (ad esempio, >=3 AND <=10) per specificare un intervallo. I filtri sui numeri possono anche utilizzare la notazione algebrica degli intervalli per filtrare i campi numerici.

Località

Le espressioni di filtro per la località si basano su latitudine e longitudine, ma possono accettare un linguaggio naturale per definire i riquadri e i cerchi entro i quali limitare una ricerca.

Unità di misura supportate

Per filtrare in un'area intorno a una determinata posizione, puoi utilizzare queste unità:

• Metri
• Piedi
• Chilometri
• Miles

Le unità di misura singolari non sono supportate. Ad esempio, il filtro per un raggio di un miglio deve essere scritto within 1 miles of 36.97, -122.03.

Valori degli attributi utente

Per utilizzare il valore di un attributo utente in un'espressione di filtro, fai riferimento all'attributo utente con la _user_attributes variabile Liquid utilizzando la sintassi richiesta dal dialetto del database:

{{ _user_attributes['name_of_attribute'] }}

Ad esempio, supponiamo che tu debba applicare un prefisso sf_ al valore dell'attributo utente salesforce_username perché è così che i valori vengono archiviati nel tuo database. Per aggiungere il prefisso al valore dell'attributo utente, puoi aggiungere un filtro Corrisponde (avanzato) nel campo pertinente e utilizzare la variabile Liquid _user_attributes nell'espressione del filtro nel seguente modo:

sf_{{_user_attributes['salesforce_username']}}

Puoi utilizzare lo stesso pattern per inserire gli attributi utente nei filtri della dashboard e nei filtri degli elementi della dashboard di LookML.