Parametri del modello

Un file modello specifica una connessione al database, definisce il set di esplorazioni che utilizzano la connessione e definisce le relazioni delle esplorazioni con altre viste. A differenza di altri elementi LookML, un modello non viene dichiarato con un parametro "model" specifico. Uno sviluppatore LookML definisce invece un modello creando un file di progetto LookML con estensione .model.lkml. Il nome del modello viene ricavato dal nome del file.

Il nome di un modello deve essere univoco in tutti i progetti dell'istanza. Se la tua istanza contiene due file .model.lkml con lo stesso nome, è probabile che si verifichino errori, ad esempio errori di configurazione del modello nella pagina Progetti LookML ed errori di rendering per gli errori della dashboard di LookML, poiché le dashboard di LookML utilizzano il nome del modello nel formato URL (<hostname>/dashboard/model_name::<dashboard_name>).

Puoi utilizzare lo strumento di convalida LookML per verificare se i nomi dei modelli sono duplicati nell'istanza. Tuttavia, anche se il validatore LookML rileva nomi di modelli duplicati nell'istanza, puoi comunque eseguire il push del codice in produzione. Pertanto, assicurati di correggere eventuali errori relativi a nomi di modelli duplicati prima di eseguire il deployment del progetto LookML in produzione.

Un file del modello in genere contiene tutte le dichiarazioni explore, insieme a una serie di impostazioni a livello di modello.

Questa pagina contiene link ai parametri LookML a livello di modello. In genere vengono scritte nella parte superiore del file del modello e non devono essere nidificate all'interno di altri parametri.

Esempio di utilizzo

Tieni il puntatore sopra il nome di un parametro per visualizzare una breve descrizione. Fai clic su un parametro per visitare la 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
include:"filename_or_pattern"
## Possibly more include declarations

explore: explore_name {
  # Desired explore parameters (described on Explore Parameters page)
}
## Possibly more explore declarations

access_grant: access_grant_name{
  user_attribute: user_attribute_name
  allowed_values: ["value_1", "value_2", ...]
}
## Possibly more access_grant declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

## DISPLAY PARAMETERS
label: "desired label"

## FILTER PARAMETERS
case_sensitive: yes | no

## QUERY PARAMETERS
connection: "connection_name"
datagroup: datagroup_name{
  label: "desired label"
  description: "desired description"
  max_cache_age: "N (minutes | hours | days)"
  sql_trigger: SQL query ;;
}
## Possibly more datagroup declarations
fiscal_month_offset: N
persist_for: "N (seconds | minutes | hours)"
persist_with: datagroup_name
week_start_day: monday | tuesday | wednesday | thursday | friday | saturday | sunday

## VISUALIZATION AND FORMATTING PARAMETERS
map_layer: map_name{
  extents_json_url: "URL to JSON extents file"
  feature_key: "Name of TopoJSON object"
  file: "TopoJSON or GeoJSON filename" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "desired label"
  max_zoom_level: number indicating max zoom
  min_zoom_level: number indicating min zoom
  projection: Preferred geographic projection
  property_key: "TopoJSON property"
  property_label_key: "Label for TopoJSON property"
  url: "URL that contains map file" # or use the file subparameter
}
## Possibly more map layer declarations

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
 }
## Possibly more named value format declarations

Definizioni dei parametri

Nome parametro	Descrizione
Parametri strutturali
access_grant	Crea una concessione di accesso che limita l'accesso alle strutture LookML solo agli utenti a cui è stato assegnato un valore dell'attributo utente approvato. Questo parametro ha i sottoparametri user_attribute e allowed_values.
explore	Mostra una visualizzazione nel menu Esplora. Per saperne di più sulle esplorazioni e sui relativi parametri, consulta la pagina Riferimento ai parametri di esplorazione.
include	Aggiunge file a un modello
test	Crea un test sui dati per verificare la logica del modello. Le impostazioni del progetto includono un'opzione per richiedere test dei dati. Se questa opzione è abilitata per un progetto, gli sviluppatori del progetto devono eseguire test sui dati prima di eseguire il deployment delle modifiche in produzione. Questo parametro ha i sottoparametri explore_source e assert.
Parametri di visualizzazione
label (per il modello)	Modifica l'aspetto di un modello nel menu Esplora
Parametri di filtro
case_sensitive (per il modello)	Specifica se i filtri sono sensibili alle maiuscole per un modello
Parametri di query
connection	Modifica la connessione al database per un modello
datagroup	Crea una policy di memorizzazione nella cache del gruppo di dati per un modello. Questo parametro ha i sottoparametri label, description, max_cache_age e sql_trigger.
fiscal_month_offset	Specifica il mese in cui inizia l'anno fiscale (se diverso dall'anno civile)
persist_for (per il modello)	Modifica le impostazioni della cache per un modello
persist_with (per il modello)	Specifica il gruppo di dati da utilizzare per il criterio di memorizzazione nella cache del modello
week_start_day	Specifica il giorno della settimana in cui devono iniziare le dimensioni correlate alla settimana
Parametri di visualizzazione e formattazione
map_layer (per il modello)	Crea mappe personalizzate da utilizzare con map_layer_name
named_value_format	Crea un formato di valore personalizzato da utilizzare con value_format_name. Questo parametro ha i sottoparametri value_format e strict_value_format.
Parametri da evitare
scoping	Rimossi 3.52 Non più richiesto
template	Removed 3.30 Non più richiesto