Un file del modello specifica una connessione al database, definisce il set di esplorazioni che utilizzano la connessione e definisce le relazioni delle esplorazioni con altre visualizzazioni. A differenza di altri elementi LookML, un modello non viene dichiarato con un parametro "model" specifico. Un modello viene definito da uno sviluppatore LookML creando un file di progetto LookML con l'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 l'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 LookML, poiché le dashboard LookML utilizzano il nome del modello nel formato dell'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 lo strumento di convalida LookML rileva nomi di modelli duplicati nell'istanza, puoi comunque eseguire il push del codice in produzione. Assicurati quindi di correggere eventuali errori di nomi di modelli duplicati prima di eseguire il deployment del progetto LookML in produzione.
Un file del modello in genere contiene tutte le explore dichiarazioni, insieme a una serie di impostazioni a livello di modello.
Questa pagina contiene i link ai parametri LookML a livello di modello. In genere vengono scritti nella parte superiore del file del modello e non devono essere nidificati all'interno di altri parametri.
Esempio di utilizzo
Tieni il puntatore sopra il nome di un parametro per visualizzarne 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 |
Espone una visualizzazione nel menu Esplora. Per ulteriori informazioni sulle esplorazioni e sui relativi parametri, consulta la pagina di riferimento dei parametri di esplorazione. |
include |
Aggiunge file a un modello |
test |
Crea un test sui dati per verificare la logica del modello. Le impostazioni progetto includono un'opzione per richiedere i test sui dati. Quando questa opzione è abilitata per un progetto, gli sviluppatori del progetto devono eseguire i 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 la modalità di visualizzazione di un modello nel menu Esplora |
| Parametri di filtro | |
case_sensitive (per il modello) |
Specifica se i filtri fanno distinzione tra maiuscole e minuscole per un modello |
| Parametri di query | |
connection |
Modifica la connessione al database per un modello |
datagroup |
Crea un criterio 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 solare) |
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 |
Rimosso nella versione 3.52 Non è più necessario |
template |
Rimosso nella versione 3.30 Non è più necessario |