etichetta (per i campi)

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

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

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

label può essere utilizzato anche nell'ambito di una vista, come descritto nella pagina della documentazione dedicata al parametro label (per le viste).

label può essere utilizzato anche come parte di una linea di riferimento, come descritto nella pagina di documentazione Parametri della linea di riferimento della dashboard.

Utilizzo

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}

Gerarchia Visualizza file view Tipo di campo label

Tipi di campi possibili Dimensione, Gruppo di dimensioni, Misura, Filtro, Parametro Accetta Una stringa

Definizione

label contribuisce a rendere le esplorazioni più intuitive consentendoti di scegliere la modalità di visualizzazione dei nomi dei campi nel selettore campi e nella tabella dati di un'esplorazione. Se non viene specificata alcuna etichetta, l'etichetta predefinita è il nome del campo.

Nota: label influisce solo sulla modalità di visualizzazione dei nomi dei campi nei contenuti di Looker. label non influisce sul modo in cui fai riferimento al campo in LookML né modifica il valore nel database. Utilizza la sintassi ${view_name.field_name} nei file LookML per fare riferimento ai campi con etichette.

Variabili Liquid con label

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

Le variabili Liquid che restituiscono un valore in base a un filtro, ad esempio _filters, o che richiedono l'esecuzione di una query, ad esempio in_query, non modificano il nome del campo nel selettore di campi. In questi casi, il nome del campo verrà 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 aveva un attributo utente denominato name con il valore "John Smith", la seguente sintassi label cambierebbe il nome del campo nel selettore di campi in John Smith:

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

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

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

Puoi vedere altri esempi di utilizzo di label con le variabili Liquid per definire etichette dinamiche nella pagina Best practice Modi interessanti per utilizzare Liquid nelle etichette.

Esempio

Visualizza questa misura come Numero di clienti anziché Conteggio clienti univoci 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 visualizzazione

Per evitare etichette di campo duplicate nella stessa visualizzazione, l'IDE di Looker mostra un'icona informativa accanto al numero di riga di eventuali etichette di campo duplicate in un file di visualizzazione LookML. Se passi il mouse sopra l'icona informativa accanto al numero di riga, la descrizione comando indica che nella visualizzazione è già presente un campo con l'etichetta.

L'IDE di Looker mostrerà le stesse informazioni nel riquadro Guida rapida se selezioni il testo dell'istruzione label nell'IDE: