label (per i campi)

Questa sezione si riferisce al parametro label che fa parte di un campo.

label può essere utilizzato anche come parte di un modello, descritto nella pagina della documentazione relativa al parametro label (per i modelli).

label può essere utilizzato anche come parte di un'esplorazione, descritto nella pagina della documentazione relativa al parametro label (per le esplorazioni).

label può essere utilizzato anche come parte di una vista, descritto nella pagina della documentazione relativa al parametro label (per viste).

label può essere utilizzato anche come parte di una riga di riferimento, descritto nella pagina della documentazione relativa ai Parametri delle righe di riferimento della dashboard.

Utilizzo

view: view_name {
dimension: field_name {
label: "nome etichetta desiderato"
}
}

Gerarchia Visualizza file view Tipo di campo label

Tipi di campi possibili Dimensione, gruppo di dimensioni, misurazione, filtro, parametro Accetta Una stringa

Definizione

label contribuisce a rendere le esplorazioni più facili da usare consentendoti di scegliere come visualizzare i nomi dei campi nel selettore campi e nella tabella dati di un'esplorazione. Se non viene specificata alcuna etichetta, per impostazione predefinita viene utilizzato il nome del campo.

L'etichetta incide soltanto sul nome visualizzato del campo in Explore e non influisce sul modo in cui fai riferimento al campo in LookML. Nei file LookML è ancora possibile fare riferimento ai campi con etichette con la normale sintassi di ${view_name.field_name}.

Variabili a liquido con label

Puoi utilizzare le variabili Liquid con il parametro label. Le variabili Liquid consentono di accedere a dati come informazioni su un modello o Esplora, filtri applicati a un campo e valori degli attributi utente. Puoi utilizzare le variabili Liquid per modificare in modo dinamico il valore label e modificare così l'aspetto del campo nel selettore campi e nelle visualizzazioni dati.

Le variabili Liquid che restituiscono un valore in base a un filtro, ad esempio _filters, o richiedono che una query venga eseguita per prima, come in_query, non modifica il nome del campo nel selettore campi. In questi casi, il nome del campo viene modificato solo nella visualizzazione risultante.

Ad esempio, la variabile Liquid {{ _user_attributes['name_of_attribute'] }} sostituisce la variabile Liquid con il valore dell'attributo utente specificato. Se un utente avesse un attributo utente chiamato name con valore "John Smith", la seguente sintassi di label modificherebbe il nome del campo nel selettore di campi in John Smith:

label: "{{ _user_attributes['name'] }}"

Nell'esempio successivo, la dimensione name utilizza la struttura Liquido {% dynamic if %} {% dynamic else %} {% dynamic endif %} con la variabile Liquid _user_attributes['name_of_attribute'] per modificare il valore label in base a un attributo utente azienda:

dimension: name {
  label: "{% dynamic if _user_attributes['company'] == 'Looker' %} Employee Name {% dynamic else %} Customer Name {% dynamic endif %}"
  sql: ${TABLE}.name ;;
}

Puoi trovare ulteriori esempi sull'utilizzo di label con variabili Liquid per definire le etichette dinamiche in questo articolo del Centro assistenza.

Esempio

Fai in modo che questa misura venga visualizzata come # di clienti anziché su Conteggio distinto cliente nel selettore di campi.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Aspetti da considerare

L'IDE segnala le etichette duplicate in una vista

Per evitare la presenza di etichette di campi duplicate nella stessa vista, l'IDE di Looker presenta un'icona delle informazioni accanto al numero di riga di tutte le etichette di campo duplicate in un file di vista LookML. Se passi il mouse sopra l'icona delle informazioni accanto al numero della riga, la descrizione comando indica che nella visualizzazione è già presente un campo con l'etichetta.

L'IDE di Looker mostrerà queste stesse informazioni nella guida rapida se fai clic sul testo dell'istruzione label nell'IDE: