Parametri di campo

Questa pagina contiene i link a tutti i parametri LookML che definiscono i campi.

Esistono diversi tipi di campi:

• Le dimensioni rappresentano una colonna in una tabella o un valore calcolato in base a una sorta di manipolazione o combinazione di colonne.
• I gruppi di dimensioni vengono utilizzati solo con i dati basati sul tempo e ti consentono di creare più dimensioni basate sul tempo contemporaneamente.
• Le misure sono simili alle funzioni di aggregazione in SQL (ad esempio COUNT, SUM, AVG) e rappresentano informazioni su più righe.
• I filtri creano un campo solo con filtri che gli utenti possono utilizzare per fornire input a un filtro basato su modello o a un join condizionale.
• I parametri creano un campo solo con filtri che gli utenti possono utilizzare per fornire input a un tag Liquid {% parameter %}

Esempio di utilizzo

Tieni il puntatore sopra il nome di un parametro per visualizzare una breve descrizione. Fai clic sul nome di un parametro per passare alla relativa pagina di riferimento.

Quando un parametro può essere impostato su una delle diverse opzioni specifiche, il valore predefinito viene elencato per primo.

## STRUCTURAL PARAMETERS
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type
# For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

Definizioni dei parametri

• D = Dimensione
• DG = Dimension Group
• M = Measure (Misura)
• F = Filter
• P = Parameter

Nome parametro	Tipi di campi validi	Descrizione
Parametri strutturali
dimension	D	Crea un campo di dimensione
dimension_group	DG	Crea più dimensioni basate sul tempo contemporaneamente
filter	F	Crea un campo solo con filtri da utilizzare in un filtro basato su modello o in un'unione condizionale
measure	M	Crea un campo di misura
parameter	P	Crea un campo solo con filtri che gli utenti possono utilizzare per fornire input a un tag Liquid {% parameter %}
intervals	DG	Definisce l'insieme di dimensioni della durata che vuoi in un dimension_group di type: duration
timeframes	DG	Definisce l'insieme di dimensioni del periodo di tempo che vuoi in un dimension_group di type: time
Parametri di azione e collegamento
action	D M	Crea un'azione sui dati in un campo che consente agli utenti di eseguire attività in altri strumenti direttamente da Looker
drill_fields	D DG M	Dichiara l'elenco dei campi che verranno visualizzati quando viene visualizzato in dettaglio la misura o la dimensione
link	D M	Crea link ad altri contenuti di Looker ed esterni
tags	D DG M F P	Aggiunge un testo che può essere trasmesso ad altre applicazioni per fornire dati su un campo
Parametri di visualizzazione
alias	D DG M F P	Consente agli URL salvati con nomi di campo precedenti di rimanere funzionali dopo la ridenominazione di un campo
alpha_sort	D	Ordina alfabeticamente le condizioni di un parametro case
description	D DG M F P	Aggiunge una descrizione al campo che gli utenti possono visualizzare quando passano il cursore sopra il campo.
group_label	D DG M F	Raggruppa i campi all'interno di una visualizzazione nel selettore di campi
group_item_label	D DG M F	Specifica un'etichetta da utilizzare per il campo sotto l'etichetta del gruppo nel selettore dei campi
hidden	D DG M F P	Nasconde un campo dall'interfaccia utente di Esplora
label	D DG M F P	Modifica la modalità di visualizzazione del nome di un campo nel selettore dei campi
label_from_parameter	D M	Modifica la modalità di visualizzazione del nome di un campo in una visualizzazione in base all'input di un parameter
order_by_field	D DG M	Ordina un campo in base ai valori di un altro campo Supportato per dimensioni e gruppi di dimensioni Supporto per le misure
style	D	Modifica la modalità di visualizzazione dei livelli nella UI di Looker per una dimensione di type: tier
view_label	D DG M F P	Modifica i campi visualizzati in una visualizzazione nel selettore di campi
Parametri di filtro
can_filter	D DG M	Determina se una dimensione o una misura può essere utilizzata come filtro
case_sensitive	D F	Determina se i filtri sono sensibili alle maiuscole per una dimensione
filter	F	Crea un campo solo con filtri da utilizzare in un filtro basato su un modello
filters	M	Limita il calcolo di una misura in base alle limitazioni delle dimensioni
skip_drill_filter	D	Impedisce l'aggiunta di una dimensione ai filtri quando viene visualizzato in dettaglio una misura
Parametri dei suggerimenti per i filtri
allowed_value	P	Specifica le scelte per un parameter
bypass_suggest_restrictions	D DG F P	Mostra suggerimenti agli utenti quando è in uso sql_always_where, ma non applica questi limiti ai suggerimenti
full_suggestions	D DG F P	Controlla il modo in cui Looker esegue query sul database per fornire suggerimenti per i valori di un campo nel filtro di un'esplorazione. Looker può utilizzare una query SELECT DISTINCT di base oppure la logica completa dell'esplorazione, inclusi join e parametri sql_always_where e access_filter.
suggest_dimension	D DG M F P	Basa i suggerimenti per un campo sui valori di una dimensione diversa
suggest_explore	D DG M F P	Basa i suggerimenti per un campo sui valori di un'esplorazione diversa
suggest_persist_for	D F P	Modifica le impostazioni della cache per i suggerimenti di filtri di Looker
suggestable	D DG M F P	Attiva o disattiva i suggerimenti per un campo
suggestions	D F P	Dichiara un elenco di valori che verranno utilizzati per i suggerimenti di un campo
Parametri di query
allow_approximate_optimization	M	Consente approssimazioni del conteggio distinto per le misure di type: count o type: count_distinct, in modo che la misura possa essere utilizzata per la notorietà aggregata
approximate	M	Esegue un conteggio approssimativo per una misura di type: count_distinct. Consulta la pagina della documentazione approximate per un elenco dei dialetti che supportano questo parametro.
approximate_threshold	M	Imposta il conteggio in corrispondenza del quale BigQuery passa da un conteggio esatto di valori distinti a un conteggio approssimativo di valori distinti
convert_tz	D DG M F P	Disattiva la conversione automatica del fuso orario per un campo
datatype	D DG F M	Specifica il tipo di dati temporali che fornisci a un campo
fanout_on	D DG M	Consente l'accesso ai campi ripetuti di Google BigQuery
precision	M	Specifica il numero di cifre decimali da utilizzare per i calcoli degli aggregati simmetrici di Looker
primary_key	D	Dichiara una dimensione come chiave primaria di una vista
required_access_grants	D DG F M P	Limita l'accesso al campo solo agli utenti i cui valori dell'attributo utente corrispondono alle concessioni di accesso
required_fields	D M	Richiede l'aggiunta di campi aggiuntivi a una query quando viene scelto un campo
sql_distinct_key	M	Definisce le entità uniche su cui verrà calcolata una misura di type: sum_distinct o type: average_distinct
Parametri di valore e formattazione
case	D	Crea un insieme discreto di valori che una dimensione può avere, determinato dalle condizioni SQL
default_value	F P	Specifica un valore predefinito per i campi filtro
direction	M	Determina la direzione in cui viene calcolata una misura di type: percent_of_total o type: running_total quando vengono utilizzati i pivot
end_location_field	D	Definisce il campo che contiene la posizione finale per un campo di type: distance
html	D DG M	Modifica l'output HTML di un campo utilizzando i modelli Liquid
list_field	M	Dichiara la dimensione da cui verrà calcolata una misura di type: list
percentile	M	Specifica il valore frazionario (l'N° percentile) per una misura di type: percentile o type: percentile_distinct
sql	D DG M F	Determina come verrà calcolato un campo
sql_end	D DG	Definisce l'ora di fine di una durata per un gruppo di dimensioni di tipo durata o una dimensione di tipo durata
sql_latitude	D	Definisce la latitudine di una dimensione di type: location
sql_longitude	D	Definisce la longitudine di una dimensione di type: location
sql_start	D DG	Definisce l'ora di inizio di una durata per un gruppo di dimensioni di tipo durata o una dimensione di tipo durata
start_location_field	D	Definisce il campo che contiene la posizione iniziale per un campo di type: distance
synonyms	D DG F M P	Specifica un elenco di sinonimi di stringhe (parole o frasi) che possono essere utilizzati per aiutare i modelli linguistici di grandi dimensioni e gli sviluppatori di app a comprendere altri modi in cui gli utenti possono fare riferimento a un campo
tiers	D	Definisce i livelli per una dimensione di type: tier
type (per dimensione, filtro o parametro)	D F P	Specifica il tipo di dimensione, filtro o parametro
type (per il gruppo di dimensioni)	DG	Specifica il tipo di gruppo di dimensioni
type (per la misura)	M	Specifica il tipo di misura
string_datatype	D	Specifica il tipo di dati Unicode per un campo di type: string per SQL Server o MySQL
units	D	Specifica le unità da utilizzare per un campo di type: distance
value_format	D M	Formatta l'output di un campo utilizzando le opzioni di stile di Excel
value_format_name	D M	Formatta l'output di un campo utilizzando un formato integrato o personalizzato
Parametri di visualizzazione
allow_fill	D DG	Determina se il riempimento delle dimensioni è consentito per una dimensione
map_layer_name	D	Specifica una mappatura da un valore di dati a una regione geografica che hai definito su una mappa integrata o personalizzata
Parametri da evitare
decimals	D M	Rimosso 5.4 Sostituito da value_format
format	D M	Rimozione di 3.16 Sostituito da value_format