Panoramica
LookML è il linguaggio utilizzato da Looker per descrivere dimensioni, aggregazioni, calcoli e relazioni tra i dati in un database SQL e per creare query SQL in base a quel database. Per la procedura consigliata per imparare a utilizzare LookML, consulta la pagina della documentazione Passaggi per imparare a utilizzare LookML.
Puoi utilizzare questa pagina di riferimento per identificare in che modo i parametri LookML possono aiutarti a ottenere gli effetti di modellazione dei dati desiderati. Questo riferimento può essere utile anche se stai esaminando un modello esistente e vuoi sapere cosa sta facendo ogni parametro. Puoi anche visitare le singole pagine di riferimento per le strutture LookML pertinenti: model, view, Explore, join, manifest o fields.
Per un'introduzione a queste strutture LookML e alla loro correlazione, consulta la pagina della documentazione relativa ai termini e concetti di LookML. Puoi trovare link a risorse aggiuntive in fondo a questa pagina per aiutarti a identificare, comprendere e implementare gli elementi LookML.
Come leggere questo riferimento
In questa pagina, i parametri sono organizzati in base alle diverse funzioni che possono eseguire e ai diversi effetti che si possono ottenere con essi.
La voce della tabella in ogni sezione elenca:
Nome parametro | Livello | Descrizione |
---|---|---|
Assegna un nome e un link alla pagina della documentazione principale del parametro | Livello a cui si applica il parametro, con un link a un elenco di tutti gli altri parametri disponibili in quel livello: model, view, Explore, join, manifest o fields. Alcuni parametri possono essere utilizzati a più livelli in LookML. | Breve descrizione della funzione del parametro e se può avere sottoparametri |
Alcuni parametri a livello di campo possono essere utilizzati con più tipi di campi, perciò in questa pagina contrassegniamo ogni parametro a livello di campo con icone che indicano i tipi di campo utilizzabili. Puoi passare il mouse sopra un'icona per visualizzarne il nome o fare clic per visualizzare una pagina di riferimento per il tipo di campo in questione.
Parametri strutturali
Questi parametri LookML influiscono sulla struttura di un progetto o dei suoi file sottostanti.
Parametri strutturali principali di un modello o di un file Esplora
Come mostrato nella pagina della documentazione Termini e concetti di LookML, un progetto contiene uno o più file modello, che utilizzano i parametri per definire un modello e le relative esplorazioni e join.
Questa sezione descrive i principali parametri strutturali che in genere inserisci in un file modello. che fungono da framework per tutti gli altri parametri. In genere, un parametro explore
viene definito al livello più alto di un file modello, ma quando utilizzi una tabella derivata nativa, questo può essere definito in un file Esplora.
Nome parametro | Livello | Descrizione |
---|---|---|
explore |
Modello | Espone una visualizzazione nel menu Esplora. Per saperne di più sulle esplorazioni e sui relativi parametri, consulta la pagina di riferimento Esplora i parametri. Questa operazione influisce sul nome e sul menu Esplora. Questo parametro include molti sottoparametri nella pagina di riferimento Esplora parametri e altrove in questa pagina. |
fields |
Esplora | Limita i campi disponibili in un'esplorazione dalla visualizzazione di base e dall'unione dell'esplorazione. Questa operazione influisce sui campi disponibili nel selettore campi. |
include |
Modello | Aggiunge file a un modello. Questo parametro può essere utilizzato anche nei file di visualizzazione per le tabelle derivate native. |
join |
Partecipa | Unisce una visualizzazione aggiuntiva all'esplorazione. Consulta anche la sezione Partecipare alle visualizzazioni di seguito. |
test |
Modello | Crea un test dei dati per verificare la logica del modello. Le impostazioni del progetto includono l'opzione per richiedere test dei dati. Se l'opzione è attivata per un progetto, gli sviluppatori del progetto devono eseguire test dei dati prima di eseguire il deployment delle modifiche in produzione. Questo parametro ha explore_source e assert sottoparametri. |
Principali parametri strutturali in un file di visualizzazione
Come mostrato nella pagina della documentazione Termini e concetti di LookML, un progetto contiene uno o più file di vista, che utilizzano i parametri per definire quella vista, i relativi campi (comprese dimensioni e misure) e i suoi insiemi di campi.
Questa sezione descrive i principali parametri strutturali che in genere inserisci in un file di vista.
Nome parametro | Livello | Descrizione |
---|---|---|
dimension
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo dimensione. Interessa il comportamento predefinito del selettore campi. |
dimension_group
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea contemporaneamente più dimensioni basate sul tempo. Interessa il comportamento predefinito del selettore campi. |
fields |
Partecipa | Determina i campi di un join che vengono portati in un'esplorazione |
measure
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo di misurazione. Interessa il comportamento predefinito del selettore campi. |
view |
Modello (ma utilizzato nel visualizza file) | Crea una vista. Interessa il comportamento predefinito del selettore campi. Questo parametro include molti parametri secondari elencati nella pagina di riferimento Visualizza parametri e altrove nella pagina corrente. |
Parametri strutturali di supporto
Questi parametri ti aiutano a definire il comportamento strutturale che ti interessa, ad esempio specificare determinati insiemi di campi, includere determinati file e i rispettivi contenuti, definizioni di riutilizzo e così via.
Nome parametro | Livello | Descrizione |
---|---|---|
+ (perfezionamenti) |
Esplora e Visualizza | Utilizza i perfezionamenti di LookML per creare in base alle visualizzazioni e alle esplorazioni dei tuoi progetti LookML. |
constant |
Manifest | Definisce una costante LookML che può essere utilizzata in tutto il progetto. Questo parametro ha value e export sottoparametri. |
extends |
Esplora e Visualizza | Riutilizza la definizione di un altro oggetto LookML, aggiungendo e sostituendo i sottoparametri in base alle tue esigenze. Questo parametro può essere utilizzato anche con le dashboard LookML. |
extension |
Esplora e Visualizza | Specifica che non è possibile utilizzare direttamente una visualizzazione, una visualizzazione o una dashboard. Invece, la definizione è intesa come un modello per altri oggetti, che utilizzano estensioni in base a questo oggetto. Questo parametro può essere utilizzato anche con le dashboard. |
include |
Modello | Aggiunge file a un modello. Questo parametro può essere utilizzato anche nei file di visualizzazione per le tabelle derivate native. |
intervals
|
Campi: DG | Definisci l'insieme di dimensioni di durata che vuoi utilizzare in una dimension_group , per i gruppi di dimensioni configurati come type: duration . Interessa il comportamento predefinito del selettore campi. |
local_dependency |
Manifest | Specifica uno o più progetti che contengono i file che vuoi includere |
parameter
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo solo filtro che gli utenti possono utilizzare per fornire l'input a un tag {% parameter %} di Liquid. Interessa il comportamento predefinito del selettore campi. |
project_name |
Manifest | Specifica il nome del progetto corrente |
remote_dependency |
Manifest | Specifica uno o più repository remoti che contengono i file che vuoi includere |
set |
View (Visualizzazione) | Definisce un insieme di dimensioni e misure da utilizzare in altri parametri. Questo parametro può essere utilizzato per limitare i campi disponibili per un join e quindi al selettore campi. Questo parametro può essere utilizzato anche per definire i campi da visualizzare quando un utente visualizza in dettaglio i dati. Questo parametro ha un sottoparametro fields . |
timeframes
|
Campi: DG | Definisce l'insieme di dimensioni del periodo di tempo che vuoi utilizzare in una dimension_group , per i gruppi di dimensioni configurati come type: time . Interessa il comportamento predefinito del selettore campi. |
Applicazioni del framework di estensioni
Gli sviluppatori di Looker possono aggiungere un'applicazione al framework delle estensioni di Looker utilizzando il parametro application
nel file manifest di un progetto. Dopo aver aggiunto un'estensione a un progetto, gli utenti di Looker con le autorizzazioni appropriate possono vedere l'estensione elencata nel menu Browse (Sfoglia) di Looker.
Se l'amministratore ha attivato la funzionalità Funzionalità di navigazione avanzata Labs, le estensioni saranno elencate nella sezione Applicazioni del nuovo pannello di navigazione avanzata sulla sinistra.
Nome parametro | Livello | Descrizione |
---|---|---|
application |
Manifest | Aggiunge un'applicazione al progetto utilizzando il framework delle estensioni di Looker. Questo parametro ha dei sottoparametri descritti nella pagina della documentazione relativa al parametro application . |
Esplora nome e menu
Il nome di un'esplorazione e il suo aspetto nel menu Esplora possono aiutare gli utenti a scegliere l'esplorazione adatta alle loro esigenze. Questi parametri LookML influiscono sul comportamento predefinito per il nome e l'aspetto di un'esplorazione nel menu Esplora.
Per ulteriori discussioni, consulta la sezione Nome e menu Esplora della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Comportamento predefinito
Il comportamento predefinito per il nome e per l'aspetto di un'esplorazione nel menu Esplora è specificato dai parametri elencati di seguito.
Nome parametro | Livello | Descrizione |
---|---|---|
explore |
Modello | Espone una visualizzazione nel menu Esplora. Per saperne di più sulle esplorazioni e sui relativi parametri, consulta la pagina di riferimento Esplora i parametri. Questa operazione influisce sul nome e sul menu Esplora. |
Modifica del nome e del menu Esplora
Il nome Esplora e il modo in cui viene visualizzato nel menu Esplora possono essere modificati dai parametri della tabella seguente.
Nome parametro | Livello | Descrizione |
---|---|---|
description |
Esplora | Aggiunge una descrizione per un'esplorazione che viene visualizzata dagli utenti nella pagina Esplora e nel menu Esplora |
group_label |
Esplora | Crea un'etichetta da utilizzare come intestazione nel menu Esplora |
hidden |
Esplora | Nasconde un'esplorazione dal menu Esplora |
label |
Esplora | Cambia la modalità di visualizzazione di un'esplorazione nel menu Esplora |
label |
Modello | Modifica la modalità di visualizzazione di un modello nel menu Esplora |
Selettore campi
L'organizzazione e i nomi visualizzati delle viste e dei campi nel selettore campi possono aiutare gli utenti a comprendere le visualizzazioni e trovare i campi di cui hanno bisogno in Esplorazioni. Questi parametri LookML influiscono sul comportamento predefinito per i contenuti, l'aspetto e l'organizzazione del selettore campi.
Per ulteriori approfondimenti, consulta la sezione Selettore campo della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Comportamento predefinito
L'aspetto e il comportamento del selettore campi predefinito sono specificati dai parametri elencati di seguito. Per una spiegazione completa di questo comportamento predefinito, consulta la sezione Visualizzazione del selettore campi della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Nome parametro | Livello | Descrizione |
---|---|---|
dimension
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo dimensione |
dimension_group
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea contemporaneamente più dimensioni basate sul tempo. |
filter
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo di solo filtro da utilizzare in un filtro basato su modelli o in un join condizionale |
measure
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo di misurazione |
parameter
|
Visualizza (ma elencato nella pagina di riferimento del campo) | Crea un campo solo filtro che gli utenti possono utilizzare per fornire l'input a un tag {% parameter %} di Liquid |
timeframes
|
Campi: DG | Definisce l'insieme di dimensioni del periodo di tempo che vuoi utilizzare in una dimension_group , per i gruppi di dimensioni configurati come type: time |
intervals
|
Campi: DG | Definisce l'insieme di dimensioni della durata che vuoi utilizzare in una dimension_group , per i gruppi di dimensioni configurati come type: duration |
view |
Modello (ma elencato nella pagina di riferimento) | Crea una vista |
Modifica dei nomi delle viste nel selettore campi
Il nome visualizzato di una visualizzazione può aiutare gli utenti a comprendere e trovare i campi di cui hanno bisogno in Esplorazioni. Se il nome della visualizzazione è indicato in una visualizzazione, la modifica del modo in cui viene visualizzato può aiutare gli utenti a capire la visualizzazione. Questa sezione descrive i parametri LookML che influiscono sui nomi delle viste nel selettore campi. Per una spiegazione completa di questo argomento, consulta la sezione Selettore campo della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Nome parametro | Livello | Descrizione |
---|---|---|
label |
View (Visualizzazione) | Specifica come verrà visualizzato il nome della vista nel selettore campi. |
view_label |
Esplora | Consente di specificare la modalità di etichettatura di un gruppo di campi della visualizzazione di base di Explore (Esplora) nel selettore di campi. |
view_label |
Partecipa | Modifica il modo in cui il nome visualizzazione del join appare nel selettore di campi. |
Modificare le schede dei campi nel selettore campi
Modificare l'elenco dei campi può aiutare gli utenti a comprendere le visualizzazioni e trovare i campi di cui hanno bisogno in Esplorazioni. Il modo in cui i campi sono elencati nel selettore campi può essere modificato dai parametri della tabella seguente. Per una spiegazione completa di questo argomento, consulta la sezione Selettore campo della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Nome parametro | Livello | Descrizione |
---|---|---|
description
|
Campi: D DG M F P | Aggiunge una descrizione al campo visibile agli utenti al passaggio del mouse |
fields |
Esplora | Limita i campi disponibili in un'esplorazione dalla visualizzazione di base e dall'unione dell'esplorazione. Questa operazione influisce sui campi disponibili nel selettore campi. |
fields |
Partecipa | Determina i campi di un join che vengono portati in un'esplorazione |
hidden
|
Campi: D DG M F P | Nasconde un campo dall'interfaccia utente di Esplora |
label
|
Campi: D DG M F P | Cambia la modalità di visualizzazione del nome di un campo nel selettore di campi. |
label_from_parameter
|
Campi: D M | Cambia la modalità di visualizzazione del nome di un campo in una visualizzazione in base al valore di parameter . |
Modifica dell'organizzazione dei campi nel selettore campi
L'organizzazione dei campi può aiutare gli utenti a trovare i campi di cui hanno bisogno in Esplorazioni. L'organizzazione dei campi nel selettore campi può essere modificata dai parametri della tabella seguente. Per una spiegazione completa di questo argomento, consulta la sezione Selettore campo della pagina della documentazione Modifica del menu Esplora e del selettore campi.
Nome parametro | Livello | Descrizione |
---|---|---|
group_label
|
Campi: D DG M F | Raggruppare i campi in una vista nel selettore campi. |
view_label
|
Campi: D DG M F P | Modifica i campi che appaiono all'interno di una vista nel selettore campi. |
Localizzazione
Se stai localizzando il tuo modello, i parametri delle impostazioni di località ti consentono di personalizzare la visualizzazione di etichette e descrizioni nella UI di Looker in base alle impostazioni internazionali dell'utente. Per informazioni sulla configurazione del modello per la localizzazione, consulta la pagina Documentazione di localizzazione.
Nome parametro | Livello | Descrizione |
---|---|---|
localization_settings |
Manifest | Specifica le informazioni di localizzazione per il modello. Questo parametro ha default_locale e localization_level sottoparametri. |
localization_level |
Manifest | Specifica se le stringhe senza traduzione sono consentite nel modello |
default_locale |
Manifest | Specifica le impostazioni internazionali che verranno utilizzate come modello predefinito per la traduzione delle stringhe |
Valori e visualizzazione dei dati
La modifica dei valori e della presentazione dei dati nella sezione Dati di un'esplorazione può aiutare gli utenti a comprendere i risultati. Ti consigliamo di modificare o limitare i tipi di dati per le dimensioni o le misure, cambiare il formato dei dati visualizzati dagli utenti, inserire i valori mancanti o modificare altre opzioni di visualizzazione.
Gli utenti possono anche definire calcoli tabulari da visualizzare nella sezione Dati. Tuttavia, quando possibile, devi definire le dimensioni e le misure in LookML in modo che il calcolo corretto venga eseguito una sola volta e poi utilizzato in modo coerente in varie query.
Valori dei dati per più tipi di campi
Questi parametri ti consentono di modificare i valori dei dati per più tipi di campi.
Nome parametro | Livello | Descrizione |
---|---|---|
case
|
Campi: D M | Crea un insieme discreto di valori che una dimensione può essere determinata dalle condizioni SQL. Questo parametro ha when e else sottoparametri. |
sql
|
Campi: D DG M F | Determina il modo in cui verrà calcolato un campo |
type (per dimensione, filtro o parametro)
|
Campi: D F P | Specifica il tipo di dimensione, filtro o parametro |
type (per gruppo di dimensioni)
|
Campi: DG | Specifica il tipo di gruppo di dimensioni |
type (per misurazione)
|
Campi: M | Specifica il tipo di misura |
Valori dei dati per tipi di dimensioni specifici
Puoi modificare i valori dei dati per alcuni tipi di dimensioni utilizzando parametri specifici.
Dimensioni di type: date
o type: datetime
Nome parametro | Livello | Descrizione |
---|---|---|
convert_tz
|
Campi: D DG F M P | Disattiva la conversione automatica del fuso orario per questo campo |
datatype
|
Campi: D DG F M | Specifica il tipo di dati da fornire al campo |
fiscal_month_offset |
Modello | Specifica il mese di inizio dell'anno fiscale (se diverso dall'anno solare) |
week_start_day |
Modello | Specifica il giorno della settimana in cui iniziare la dimensione relativa alla settimana. |
Dimensioni di type: distance
Nome parametro | Livello | Descrizione |
---|---|---|
end_location_field
|
Campi: D | Definisce il campo contenente la posizione finale per un campo di type: distance . Questo parametro è anche considerato un parametro strutturale. |
start_location_field
|
Campi: D | Definisce il campo che contiene la posizione iniziale per un campo di type: distance . |
units
|
Campi: D | Specifica l'unità da utilizzare per i campi type: distance |
Dimensioni di type: location
Nome parametro | Livello | Descrizione |
---|---|---|
sql_latitude
|
Campi: D | Definisce la latitudine di una dimensione pari a type: location |
sql_longitude
|
Campi: D | Definisce la longitudine di una dimensione di type: location |
Dimensioni di type: string
Nome parametro | Livello | Descrizione |
---|---|---|
string_datatype
|
Campi: D | Specifica il tipo di dati Unicode per una dimensione di type: string per SQL Server o MySQL |
Dimensioni di type: tier
Nome parametro | Livello | Descrizione |
---|---|---|
tiers
|
Campi: D | Definisce i livelli per una dimensione di type: tier |
Gruppi di dimensioni (type: duration
) o dimensioni (type: duration_x
)
Nome parametro | Livello | Descrizione |
---|---|---|
sql_start
|
Campi: D DG | Definisce l'ora di inizio di una durata per un gruppo di dimensioni type: duration o una dimensione type: duration_x . |
sql_end
|
Campi: D DG | Definisce l'ora di fine di una durata per un gruppo di dimensioni type: duration o una dimensione type: duration_x . |
Valori dei dati per le misure
La maggior parte di questi parametri è limitata a tipi di misurazioni specifici, come specificato nella tabella. Per creare un conteggio filtrato in base a un valore dimensionale, consulta Filtro dei conteggi in base a una dimensione. Per creare una misura che calcola la percentuale tra due campi, consulta la sezione Percentuali.
Nome parametro | Livello | Descrizione |
---|---|---|
approximate |
Campi: M | Esegue un conteggio approssimativo delle misure di type: count_distinct . Consulta la pagina della documentazione di approximate per un elenco dei dialetti che supportano questo parametro. |
approximate_threshold
|
Campi: M | Imposta il conteggio a partire dal quale BigQuery passa da un conteggio esatto distinto a un conteggio approssimativo distinto. |
direction
|
Campi: M | Determina la direzione in cui vengono calcolate le misurazioni di type: percent_of_total o di type: running_total quando vengono utilizzati i pivot. |
list_field
|
Campi: M | Dichiara la dimensione da cui verrà calcolata una misura di type: list . Questo parametro è anche considerato un parametro strutturale. |
percentile
|
Campi: M | Specifica il valore frazionario (n° percentile) per una misura di type: percentile o type: percentile_distinct |
primary_key
|
Campi: D | Dichiarare una dimensione come chiave principale di una vista |
sql_distinct_key
|
Campi: M | Definisce le entità univoche su cui verrà calcolata una misura distinta, ad esempio type: sum_distinct o type: average_distinct |
symmetric_aggregates |
Esplora | Specifica se gli aggregati simmetrici sono abilitati per un'esplorazione. Questo parametro è elencato anche per i parametri che influiscono sul comportamento di un join. Consulta anche la sezione Partecipare alle visualizzazioni di seguito. |
Formati di dati
Puoi rendere i valori dei dati più facili da leggere per gli utenti formattandoli utilizzando i parametri nella tabella seguente.
Nome parametro | Livello | Descrizione |
---|---|---|
html
|
Campi: D DG M | Modifica l'output HTML di un campo utilizzando i modelli Liquid |
named_value_format |
Modello | Crea un formato del valore personalizzato da utilizzare con value_format_name . Questo parametro ha value_format e strict_value_format sottoparametri. |
style
|
Campi: D | Cambia la modalità di visualizzazione dei livelli nell'interfaccia utente di Looker per una dimensione type: tier |
value_format
|
Campi: D M | Formatta l'output di un campo utilizzando le opzioni in stile Excel |
value_format_name
|
Campi: D M | Formatta l'output di un campo utilizzando un formato integrato o personalizzato |
Ordine e riempimento dei dati
Per la maggior parte dei campi, l'ordinamento è semplice: è solo un ordinamento alfanumerico dei valori. In alcuni casi, potresti voler ordinare i risultati di un'istruzione New LookML case
o Old LookML sql_case
in un determinato ordine. oppure potresti ordinare i valori in base al valore di un altro campo. Puoi anche utilizzare il parametro allow_fill
per consentire o impedire agli utenti di chiedere a Looker di compilare date e valori mancanti per un campo.
Nome parametro | Livello | Descrizione |
---|---|---|
allow_fill
|
Campi: D DG | Determina se il riempimento delle dimensioni è consentito per una dimensione |
alpha_sort
|
Campi: D | Imposta un parametro case per ordinare le condizioni in ordine alfabetico
|
order_by_field
|
Campi: D DG | Ordina un campo in base ai valori di un altro campo Supportato per i gruppi di dimensioni |
Visualizzazione dei dati sulla posizione
Looker fornisce una serie di mappe che puoi rendere disponibili per visualizzare i valori dei dati sulla posizione nella sezione Visualizzazione. Puoi anche creare e utilizzare mappe personalizzate per le visualizzazioni.
Nome parametro | Livello | Descrizione |
---|---|---|
map_layer |
Modello | Crea mappe personalizzate da utilizzare con map_layer_name . Questo parametro include molti parametri secondari nella pagina map_layer . |
map_layer_name
|
Campi: D | Specifica una mappatura di un valore di dati a un'area geografica che hai definito su una mappa integrata o personalizzata. |
Azioni cliccabili per valori dei dati
Trivellazioni
In Looker, ogni risultato di query può essere il punto di partenza per un'altra query. Gli utenti possono fare clic su un valore per visualizzare i dati. Puoi anche utilizzare LookML per specificare quali campi vengono visualizzati quando l'utente visualizza i dati in dettaglio. Le dimensioni e le misure hanno un comportamento predefinito diverso per il drill-down.
Per opzioni avanzate per creare un percorso di visualizzazione personalizzato, consulta l'articolo Visualizzazione più dettagliata dei dati nel Centro assistenza.
Nome parametro | Livello | Descrizione |
---|---|---|
drill_fields
|
Campi: D DG M | Dichiara l'elenco di campi che verranno visualizzati quando viene mostrata la dimensione o la dimensione |
set |
View (Visualizzazione) | Definisce un insieme di dimensioni e misure da utilizzare in altri parametri. Questo parametro può essere utilizzato per limitare i campi disponibili a un join e quindi al selettore di campi. Questo parametro può essere utilizzato anche per definire quali campi devono essere visualizzati quando un utente esamina in dettaglio i dati. Consulta inoltre Utilizzo degli insiemi per i dettagli di visualizzazione in dettaglio nella pagina della documentazione Nozioni di base su LookML aggiuntive. |
Azioni sui dati
A volte gli utenti vogliono essere in grado di attivare altri eventi dopo aver visualizzato i dati. Se utilizzi l'Action Hub di Looker, puoi specificare che i campi con una determinata tags
possano utilizzare servizi integrati specifici. Puoi anche utilizzare le azioni relative ai dati per specificare le opzioni disponibili per gli utenti per un campo.
Nome parametro | Livello | Descrizione |
---|---|---|
action
|
Campi: D M | Crea un'azione per i dati in un campo che consente agli utenti di eseguire attività in altri strumenti direttamente da Looker. Questo parametro include molti parametri secondari nella pagina action . |
tags
|
Campi: D DG M F P | Aggiunge testo che può essere trasmesso ad altre applicazioni per fornire dati relativi a un campo |
Collegamento
Puoi consentire agli utenti di fare clic su un valore di dati per passare a un URL correlato. Questi parametri consentono di specificare i campi da visualizzare quando l'utente visualizza i dati, nonché il testo da visualizzare, l'URL di destinazione e una favicon per il sito web di destinazione.
Nome parametro | Livello | Descrizione |
---|---|---|
link
|
Campi: D M | Crea link ad altri contenuti Looker e esterni. Questo parametro ha i sottoparametri label , url e icon_url . Per le opzioni avanzate che utilizzano link , consulta anche l'articolo Visualizzazione più approfondita dei dati nel Centro assistenza. |
Filtri
Gli utenti possono applicare filtri alle proprie query in Esplorazioni, Look e dashboard.
Puoi contribuire alla cura dell'esperienza utente specificando il comportamento dei filtri direttamente nel LookML, ad esempio aggiungendo filtri utili o assicurandoti che non creino accidentalmente una query che pone troppo domanda nelle risorse del tuo database. Puoi specificare i comportamenti dei filtri, come la sensibilità alle maiuscole, i valori predefiniti e i suggerimenti per i filtri che Looker può generare mentre l'utente sta digitando.
Per informazioni più generali sul filtraggio in LookML, consulta la sezione Filtri dei set di risultati nella pagina della documentazione Nozioni di base su LookML aggiuntive. Per opzioni avanzate che utilizzano i filtri basati su modelli, consulta gli articoli Filtri basati su modelli e Parametri di Liquid e Filtri avanzati basati su modelli nel Centro assistenza.
Puoi trovare un elenco completo delle espressioni e della sintassi dei filtri nella pagina della documentazione Espressioni del filtro Looker.
Richiesta di filtri con valori fissi
Questi parametri consentono di specificare filtri da applicare sempre.
Vedi anche Filtro dei conteggi in base a una dimensione nella pagina della documentazione Nozioni di base su LookML aggiuntive.
Nome parametro | Livello | Descrizione |
---|---|---|
access_filter |
Esplora | Aggiunge filtri specifici dell'utente a un'esplorazione. Questo parametro ha i sottoparametri field e user_attribute . |
sql_always_having |
Esplora | Inserisce le condizioni nella clausola HAVING della query che un utente non può modificare o rimuovere per questa esplorazione |
sql_always_where |
Esplora | Inserisce le condizioni nella clausola WHERE della query che un utente non può modificare o rimuovere per questa esplorazione |
sql_where |
Partecipa | Se questo join è incluso nella query, inserisce nella condizione WHERE della query le condizioni che un utente non può modificare o rimuovere per questa esplorazione. Solo per BigQuery. Questo parametro può anche essere considerato un filtro. |
Richiedere filtri con valori modificabili
Questi parametri consentono di specificare i filtri da utilizzare, ma consentono all'utente di modificare i valori dei filtri.
Nome parametro | Livello | Descrizione |
---|---|---|
always_filter |
Esplora | Aggiunge a un'esplorazione un filtro che l'utente può modificare, ma non rimuovere. Questo parametro ha un sottoparametro filters . |
filter
|
Campi: F | Crea un campo solo filtro da utilizzare in un filtro basato su modello |
filters
|
Campi: M | Limita il calcolo di una misura in base alle limitazioni delle dimensioni |
Prevenzione dei filtri
Questi parametri consentono di impedire a un utente di utilizzare un campo come filtro, in tutte le circostanze o solo durante l'attività di drill-down.
Nome parametro | Livello | Descrizione |
---|---|---|
can_filter
|
Campi: D DG M | Determina se una dimensione o una misura può essere utilizzata come filtro |
skip_drill_filter
|
Campi: D | Impedisce l'aggiunta di una dimensione ai filtri quando viene eseguita una visualizzazione in dettaglio di una misura |
Filtri condizionali
In alcuni casi, potresti voler specificare che l'utente deve utilizzare uno dei vari filtri per restringere la query. Ad esempio, l'utente deve limitare la query in base alla data o all'area geografica.
Oltre al parametro riportato di seguito, consulta la sezione Filtri dei set di risultati nella pagina della documentazione Nozioni di base su LookML aggiuntive.
Nome parametro | Livello | Descrizione |
---|---|---|
conditionally_filter |
Esplora | Aggiunge filtri a un'esplorazione se un utente non aggiunge il proprio filtro a un elenco specifico. Questo parametro ha filters e unless sottoparametri. |
Comportamento del valore del filtro
Per semplificare l'applicazione di filtri per gli utenti, puoi fornire un valore predefinito per il filtro o trattare i valori senza distinzione tra maiuscole e minuscole.
Nome parametro | Livello | Descrizione |
---|---|---|
case_sensitive |
Esplora | Specifica se i filtri sono sensibili alle maiuscole per un'esplorazione |
case_sensitive
|
Campi: D F | Specifica se i filtri sono sensibili alle maiuscole per una dimensione |
case_sensitive |
Modello | Specifica se i filtri sono sensibili alle maiuscole per un modello |
default_value
|
Campi: F P | Specifica un valore predefinito per i campi filtro |
Suggerimenti per i filtri
I suggerimenti relativi ai filtri sono un ottimo metodo per aiutare gli utenti a filtrare i dati in modo efficace. In alcuni casi può essere utile disattivare i suggerimenti o modificarne il comportamento.
Questi parametri LookML influiscono sul comportamento predefinito per i suggerimenti di filtro.
Comportamento predefinito
Per impostazione predefinita, i suggerimenti di Looker per un determinato campo di filtro sono basati su tutti i valori univoci nei dati di quel campo.
Attivazione o disattivazione dei suggerimenti
Se ritieni che un campo contenga un numero molto elevato di valori unici, potrebbe essere opportuno disattivare i suggerimenti di filtro per tale campo. Ciò impedisce all'utente di dover scorrere troppi suggerimenti e che il database deve fornire quei suggerimenti. Puoi attivare o disattivare i suggerimenti di filtro a più livelli.
Nome parametro | Livello | Descrizione |
---|---|---|
suggestable
|
Campi: D DG M F P | Attiva o disattiva i suggerimenti per un campo |
suggestions |
View (Visualizzazione) | Attiva o disattiva i suggerimenti per tutte le dimensioni in questa visualizzazione |
Valori dei suggerimenti
Per impostazione predefinita, Looker genera suggerimenti per i filtri in base ai valori unici di un campo. In alcuni casi, i suggerimenti potrebbero essere più utili se hai specificato i valori che Looker dovrebbe consigliare, come quelli più probabili. Inoltre, se limiti l'accesso ad alcuni valori nei dati, puoi scegliere di applicare o meno tali limiti ai suggerimenti.
Nome parametro | Livello | Descrizione |
---|---|---|
allowed_value
|
Campi: P | Specifica le opzioni per parameter . Questo parametro ha label e value sottoparametri. |
bypass_suggest_restrictions
|
Campi: D DG F P | Mostra i suggerimenti agli utenti quando sql_always_where è in uso, ma non applica tali limiti. |
full_suggestions
|
Campi: D DG F P | Mostra agli utenti i suggerimenti quando sql_always_where è in uso e applica tali limiti ai suggerimenti. |
suggest_dimension
|
Campi: D DG M F P | Basa i suggerimenti per un campo sui valori di una dimensione diversa |
suggest_explore
|
Campi: D DG M F P | Basa i suggerimenti per un campo sui valori di un'esplorazione diversa |
suggestions
|
Campi: D F P | Dichiara un elenco di valori che verranno utilizzati per i suggerimenti di un campo |
Suggerimenti per la memorizzazione nella cache
Per impostazione predefinita, Looker genera suggerimenti per i filtri in base ai valori unici di un campo. Questi valori vengono memorizzati nella cache per migliorare il rendimento, ma puoi modificare la durata dell'utilizzo dei valori memorizzati nella cache. Se i dati sono abbastanza stabili, valuta la possibilità di utilizzare un periodo di tempo più lungo per migliorare il rendimento per ottenere i valori dei suggerimenti.
Nome parametro | Livello | Descrizione |
---|---|---|
suggest_persist_for
|
Campi: D F P | Modifica le impostazioni della cache per i suggerimenti per i filtri di Looker |
Partecipazione alle visualizzazioni
Come spiegato in Utilizzo delle join in LookML, le join consentono di esplorare i dati da più di una vista contemporaneamente. Puoi unire diverse visualizzazioni per consentire agli utenti di vedere in che modo le parti dei tuoi dati sono correlate tra loro.
I join sono definiti nel file modello per stabilire la relazione tra un'esplorazione e una vista. Gli join collegano una o più visualizzazioni in una singola esplorazione, direttamente o tramite un'altra visualizzazione congiunta.
Questi parametri LookML ti consentono di creare unioni e di specificarne il funzionamento.
A cosa devi partecipare
Esistono diversi parametri che specificano le viste da unire, in situazioni generali e specifiche. Inoltre, puoi specificare i campi da includere nel join.
Nome parametro | Livello | Descrizione |
---|---|---|
always_join |
Esplora | Specifica quali join devono sempre essere applicati a un'esplorazione |
fields |
Partecipa | Determina i campi di un join che vengono portati in un'esplorazione |
from |
Partecipa | Specifica la visualizzazione su cui si baserà un join |
include |
Modello | Aggiunge file a un modello. Solo le visualizzazioni nei file disponibili nel modello possono essere utilizzate per le unioni |
join |
Esplora | Unisce una visualizzazione aggiuntiva all'esplorazione. Per maggiori informazioni sulle unioni e sui relativi parametri, consulta la pagina di riferimento Unisci parametri. Questo parametro ha molti sottoparametri elencati altrove nella pagina corrente. |
required_joins |
Partecipa | Specifica quali join devono essere applicati a un Explore quando vengono scelti i campi di un determinato join |
sql_table_name |
Partecipa | Specifica la tabella di database su cui si baserà un join |
Come partecipare
Puoi specificare come dovrebbero funzionare le unioni tra le visualizzazioni e quale sarà la condizione di unione. Devi anche specificare una chiave primaria in modo che Looker possa utilizzare gli aggregati simmetrici per fornire risultati corretti per le funzioni aggregate.
Per ulteriori approfondimenti sugli aggregati simmetrici, consulta anche gli articoli Una semplice spiegazione degli aggregati simmetrici o "Perché sulla Terra il mio SQL ha questo aspetto?" e Il problema dei fanout SQL.
Nome parametro | Livello | Descrizione |
---|---|---|
foreign_key |
Partecipa | Specifica una relazione tra un Explore e un join utilizzando la chiave primaria della visualizzazione unita |
outer_only |
Partecipa | Specifica se tutte le query devono utilizzare un join esterno |
primary_key
|
Campi: D | Dichiarare una dimensione come chiave principale di una vista |
relationship |
Partecipa | Dichiarano che un join ha una relazione one-to-one, one-to-one, one-to-many o one-to-many |
sql_on |
Partecipa | Specifica una relazione tra un Explore e un join scrivendo una clausola SQL ON |
symmetric_aggregates |
Esplora | Specifica se gli aggregati simmetrici sono abilitati per un'esplorazione. Questo parametro è elencato anche con i parametri che influenzano il valore di misurazione. |
type |
Partecipa | Dichiarare che un join è sinistro, pieno, interno o di tipo incrociato |
Memorizzazione nella cache
Looker riduce il carico sul database e migliora le prestazioni utilizzando i risultati delle query precedenti memorizzati nella cache quando disponibili e se consentito dai criteri di memorizzazione nella cache. Inoltre, puoi creare query complesse come tabelle derivate permanenti (PDT), che archiviano i risultati per semplificare le query successive. Quando pianifichi la memorizzazione nella cache, devi tenere conto sia delle prestazioni sia del grado di "aggiornamento" dei dati per gli utenti.
Memorizzazione nella cache delle query
Puoi utilizzare i gruppi di dati per integrare meglio Looker con la fase ETL (estrazione, trasformazione e caricamento) della tua pipeline di dati. Ad esempio, se carichi i dati in batch tramite un job ETL notturno, puoi richiedere a Looker di sapere che l'ETL ha terminato e cancella tutte le query correlate memorizzate nella cache.
Per ulteriori approfondimenti, consulta la pagina Documentazione sulla memorizzazione nella cache e la ricostruzione delle PDT con i gruppi di dati.
Nome parametro | Livello | Descrizione |
---|---|---|
datagroup |
Modello | Crea un criterio di memorizzazione nella cache del gruppo di dati per il modello. Questo parametro ha max_cache_age , sql_trigger , label e description sottoparametri. |
persist_for |
Esplora | Modifica le impostazioni della cache per un'esplorazione. Prendi in considerazione l'utilizzo della maggiore funzionalità di un parametro del gruppo di dati. |
persist_for |
Modello | Modifica le impostazioni della cache per un modello. Prendi in considerazione l'utilizzo della maggiore funzionalità di un parametro del gruppo di dati. |
persist_with |
Esplora | Specifica il gruppo di dati da utilizzare per il criterio di memorizzazione nella cache di Explore |
persist_with |
Modello | Specifica il gruppo di dati da utilizzare per il criterio di memorizzazione nella cache del modello |
Suggerimenti per i filtri nella cache
Per impostazione predefinita, Looker genera suggerimenti per i filtri in base ai valori unici di un campo. Questi valori vengono memorizzati nella cache per migliorare il rendimento, ma puoi modificare la durata dell'utilizzo dei valori memorizzati nella cache. Se i dati sono abbastanza stabili, valuta la possibilità di utilizzare un tempo di cache più lungo per migliorare il rendimento per ottenere i valori dei suggerimenti.
Nome parametro | Livello | Descrizione |
---|---|---|
suggest_persist_for
|
Campi: D F P | Modifica le impostazioni della cache per i suggerimenti per i filtri di Looker |
memorizzazione nella cache per tabelle derivate permanenti
Consulta Parametri di rigenerazione e memorizzazione nella cache per le tabelle derivate permanenti di seguito per i parametri che influiscono sulla memorizzazione nella cache delle tabelle derivate permanenti.
Tabelle derivate
Come discusso nel tutorial Tabelle derivate in Looker, le tabelle derivate sono strumenti importanti in Looker. Consentono di creare nuove tabelle che non esistono già nel database, espandere la complessità delle analisi e migliorare le prestazioni delle query.
Per ulteriori discussioni, consulta le tabelle derivate e le tabelle di dati e le tabelle derivate permanenti nella pagina della documentazione Termini e concetti di LookML.
Parametri strutturali per tutte le tabelle derivate
Le tabelle derivate possono essere definite utilizzando SQL o LookML. Tutte le tabelle derivate iniziano con questo parametro:
Nome parametro | Livello | Descrizione |
---|---|---|
derived_table |
View (Visualizzazione) | Basa una vista su una tabella derivata. Questo parametro ha molti sottoparametri elencati altrove nella pagina corrente e mostrati nella tabella di utilizzo di esempio nella pagina della documentazione Visualizza parametri. |
Parametri strutturali per le tabelle derivate native
Le tabelle derivate native sono molto più facili da leggere, comprendere e spiegare durante la creazione dei dati.
I parametri nella tabella seguente sono utilizzati per definire i dati di origine per una tabella derivata nativa. Sono descritti in modo più dettagliato e mostrati nell'esempio di utilizzo nella pagina della documentazione del parametro explore_source
.
Nome parametro | Livello | Descrizione |
---|---|---|
bind_all_filters |
View (Visualizzazione) | Utilizza il valore explore_source per trasmettere tutti i filtri della query Esplora alla sottoquery della tabella derivata nativa. Per un esempio, consulta la pagina della documentazione relativa al parametro explore_source .
NOTA: il parametro explore_source può avere il sottoparametro bind_all_filters o il sottoparametro bind_filters , ma non entrambi.
|
bind_filters |
View (Visualizzazione) | Utilizza il campo explore_source per passare un filtro dalla query Esplora alla sottoquery della tabella derivata nativa. Per configurarlo, utilizza il sottoparametro from_field per specificare un campo definito nella visualizzazione della tabella derivata nativa o accessibile in Esplora a cui viene unita la tabella derivata nativa. In fase di esecuzione, tutti i filtri di from_field in Esplora verranno trasferiti in to_field nella sottoquery di tabella derivata nativa. Per un esempio, consulta la pagina della documentazione relativa al parametro explore_source .
NOTA: il parametro explore_source può avere il sottoparametro bind_all_filters o il sottoparametro bind_filters , ma non entrambi.
|
column |
View (Visualizzazione) | Utilizza explore_source per specificare una colonna da includere nella tabella. Questo parametro ha un sottoparametro field . |
derived_column |
View (Visualizzazione) | Specifica una colonna in explore_source con un'espressione nello spazio dei nomi delle colonne interne. Le espressioni SQL aggregate non funzioneranno qui, poiché non è presente alcun raggruppamento SQL in questo passaggio. Ciò è particolarmente utile per definire le funzioni della finestra, se applicabili. Questo parametro ha un sottoparametro sql . |
explore_source |
View (Visualizzazione) | Genera SQL per una tabella derivata in base alla sua esplorazione associata. explore_source ha vari sottoparametri descritti nelle altre righe di questa tabella e nella sua pagina della documentazione principale. |
expression_custom_filter |
View (Visualizzazione) | Specifica un'espressione di filtro personalizzata in una query explore_source . Facoltativo. |
filters |
View (Visualizzazione) | Specifica un'espressione di filtro personalizzata in una query explore_source . Facoltativo. |
include |
Modello | Include il file o i file contenenti i campi a cui fare riferimento nella tabella, come spiegato nella pagina della documentazione di explore_source . Consulta la pagina della documentazione principale per gli altri usi del parametro include , ad esempio per aggiungere file a modelli e viste, e consulta la sezione Visualizzazioni di unione in alto per utilizzare include per creare unioni. |
limit |
View (Visualizzazione) | Specifica il limite di righe della query. Facoltativo. |
sorts |
View (Visualizzazione) | Facoltativo. Specifica un ordinamento per questo explore_source . Racchiudi tra parentesi quadre il nome del campo da ordinare, seguito da : , quindi indica se il campo deve essere ordinato in ordine crescente o decrescente utilizzando la parola chiave asc o desc . |
timezone |
View (Visualizzazione) | Imposta il fuso orario per la query explore_source . Per le tabelle derivate temporanee (non persistenti), imposta questo parametro su query_timezone in modo che utilizzi automaticamente il fuso orario della query in esecuzione. Se il fuso orario non è specificato, per impostazione predefinita la query explore_source non esegue alcuna conversione del fuso orario e opera nel fuso orario del database. |
Parametri strutturali per le tabelle derivate da SQL
Per le tabelle SQL derivate, utilizza il parametro elencato di seguito.
Nome parametro | Livello | Descrizione |
---|---|---|
sql (per deriva_table) |
View (Visualizzazione) | Dichiara la query SQL per una tabella derivata |
Parametri strutturali per la definizione dei dati personalizzati
Per i dialetti del database che richiedono un linguaggio DDL (Data Definition Language) personalizzato, utilizza i parametri elencati di seguito. Ad esempio, se il dialetto del database non supporta CREATE TABLE as SELECT
come istruzione SQL singola, utilizza il parametro create_process
per creare una PDT in più passaggi:
Nome parametro | Livello | Descrizione |
---|---|---|
create_process |
View (Visualizzazione) | Specifica una serie di istruzioni SQL che verranno eseguite una alla volta nell'ordine indicato. Ogni singola istruzione SQL viene specificata utilizzando il sottoparametro sql_step . |
sql_create |
View (Visualizzazione) | Definisce un'istruzione SQL CREATE per creare una PDT in un dialetto del database che richiede comandi DDL personalizzati |
Parametri di rigenerazione e di memorizzazione nella cache per le tabelle derivate permanenti
Come spiegato in precedenza nella sezione Memorizzazione nella cache, puoi utilizzare i gruppi di dati per gestire la memorizzazione nella cache e bilanciare l'efficienza con l'aggiornamento dei dati.
Puoi utilizzare i gruppi di dati per rigenerare le tabelle derivate permanenti (PDT) quando diventano disponibili dati aggiornati. In alternativa, puoi specificare che le PDT vengano rigenerate di rado, anche se le tabelle sottostanti vengono aggiornate di frequente, in modo che le query sulle PDT possano essere memorizzate nella cache più a lungo.
Per ulteriori discussioni, vedi Strategie di persistenza nella pagina della documentazione Tabelle derivate in Looker e nella pagina di documentazione Memorizzazione nella cache e ricreazione delle PDT con gruppi di dati.
Nome parametro | Livello | Descrizione |
---|---|---|
datagroup_trigger |
View (Visualizzazione) | Specifica il gruppo di dati da utilizzare per il criterio di ricreazione delle PDT |
persist_for (per deriva_table) |
View (Visualizzazione) | Imposta l'età massima di una PDT prima che venga rigenerata. Prendi in considerazione l'utilizzo del parametro datagroup_trigger più potente. |
sql_trigger_value |
View (Visualizzazione) | Specifica la condizione che determina la rigenerazione di una PDT. Prendi in considerazione l'utilizzo del parametro datagroup_trigger più potente. |
Parametri di efficienza delle query per le tabelle derivate
A seconda del dialetto del tuo database, puoi utilizzare alcuni parametri per migliorare l'efficienza della tabella derivata.
Nome parametro | Livello | Descrizione |
---|---|---|
cluster_keys |
View (Visualizzazione) | Specifica che una PDT o una tabella aggregata deve essere clusterata da uno o più campi in BigQuery Supporto aggiunto per cluster_keys su Snowflake
Supporto aggiunto per cluster_keys con tabelle aggregate |
distribution |
View (Visualizzazione) | Imposta la chiave di distribuzione di una PDT o di una tabella aggregata creata in Redshift o Aster Supporto aggiunto per distribution con tabelle aggregate |
distribution_style |
View (Visualizzazione) | Imposta lo stile di distribuzione di una PDT o di una tabella aggregata creata in Redshift Supporto aggiunto per distribution_style con tabelle aggregate |
increment_key |
View (Visualizzazione) |
AGGIUNTO 21.4
Trasforma la tabella derivata in una PDT incrementale. increment_key specifica l'incremento di tempo per il quale eseguire query su dati aggiornati e aggiungerli alla PDT |
increment_offset |
View (Visualizzazione) |
AGGIUNTO 21,4
Utilizzato in combinazione con il parametro increment_key per le PDT incrementali. increment_offset specifica il numero di periodi di tempo precedenti (al livello di granularità della chiave di incremento) che vengono ricreati per tenere conto dei dati in arrivo tardivi. |
indexes |
View (Visualizzazione) | Imposta gli indici di una PDT o di una tabella aggregata creata in un database tradizionale (ad es. MySQL, Postgres) o una chiave di ordinamento con interfoliazione in Redshift Supporto aggiunto per indexes con tabelle aggregate |
partition_keys |
View (Visualizzazione) | Specifica che una PDT o una tabella aggregata devono essere partizionate da uno o più campi in Presto o da un singolo campo data/ora in BigQuery Supporto aggiunto per partition_keys con tabelle aggregate |
sortkeys |
View (Visualizzazione) | Imposta le chiavi di ordinamento di una PDT o di una tabella aggregata creata in Redshift Supporto aggiunto per sortkeys con tabelle aggregate |
table_compression |
View (Visualizzazione) | Specifica la compressione della tabella da utilizzare per una PDT in Amazon Athena |
table_format |
View (Visualizzazione) | Specifica il formato tabella da utilizzare per una PDT in Amazon Athena |
Tabelle aggregate
Come spiegato nella pagina Documentazione di Awareness aggregato, le tabelle aggregate possono aiutarti a ottimizzare le query nelle esplorazioni. Le tabelle aggregate vengono mantenute nel tuo database, in modo simile alle tabelle derivate persistenti (PDT).
Le tabelle aggregate sono definite in un'esplorazione.
Nome parametro | Livello | Descrizione |
---|---|---|
aggregate_table |
Esplora | Crea una tabella aggregata per un'esplorazione. Questo parametro ha dei sottoparametri descritti nella pagina della documentazione relativa al parametro aggregate_table . |
Parametri aggiuntivi di comportamento delle query
Esistono diversi parametri che influiscono su come e quando esegui query, alcuni dei quali sono stati descritti in altre sezioni di questa pagina in base al loro comportamento. La sezione descrive i parametri LookML rimanenti che ti consentono di stabilire il comportamento della query.
Che cosa eseguire query
Questi parametri definiscono informazioni specifiche sulle connessioni, sui file e sui campi che verranno utilizzati per le tue query.
Nome parametro | Livello | Descrizione |
---|---|---|
access_grant |
Modello | Crea una concessione di accesso che limita l'accesso alle strutture LookML solo per gli utenti con valori di attributi utente approvati. Questo parametro ha user_attribute e allowed_values sottoparametri. |
connection |
Modello | Modifica la connessione al database per un modello |
fanout_on
|
Campi: D DG M | Consente l'accesso ai campi ripetuti di Google BigQuery |
from |
Esplora | Specifica la vista su cui si baserà un'esplorazione e fa riferimento ai campi di tale visualizzazione in base al nome dell'esplorazione |
required_access_grants |
Esplora | Limita l'accesso a un'esplorazione solo agli utenti i cui valori degli attributi utente corrispondono alle concessioni di accesso |
required_access_grants |
Partecipa | Limita l'accesso a un join solo agli utenti i cui valori di attributi utente corrispondono alle concessioni di accesso |
required_access_grants |
View (Visualizzazione) | Limita l'accesso a una vista solo agli utenti i cui valori di attributi utente corrispondono alle concessioni di accesso |
required_access_grants |
Campi: D DG M F P | Limita l'accesso a un campo ai soli utenti i cui valori degli attributi utente corrispondono alle concessioni di accesso |
required_fields
|
Campi: D M | Richiede l'aggiunta di altri campi a una query quando viene scelto un campo |
sql_table_name |
Esplora | Specifica la tabella di database su cui si baserà un'esplorazione |
sql_table_name |
View (Visualizzazione) | Modifica la tabella SQL su cui si basa una visualizzazione |
view_name |
Esplora | Specifica la vista su cui si basa un'esplorazione e fa riferimento ai campi di tale visualizzazione in base al nome della visualizzazione. |
Come eseguire una query
Questi parametri influenzano il modo in cui Looker costruisce o gestisce le tue query.
Molti di questi parametri contribuiscono a garantire il funzionamento degli aggregati simmetrici. Per un'ulteriore discussione sugli aggregati simmetrici, consulta anche l'articolo Una semplice spiegazione degli aggregati simmetrici o l'articolo "Perché mai il mio SQL è simile a questo?" del Centro assistenza.
Nome parametro | Livello | Descrizione |
---|---|---|
alias
|
Campi: D DG M F P | Consente agli URL salvati con nomi di campo precedenti di rimanere funzionanti dopo aver rinominato un campo |
cancel_grouping_fields |
Esplora | Annulla la clausola GROUP BY quando alcuni campi vengono scelti in un'esplorazione |
primary_key
|
Campi: D | Dichiarare una dimensione come chiave principale di una vista |
sql_where |
Partecipa | Se questa unione è inclusa nella query, inserisce nella condizione WHERE della query le condizioni che un utente non può modificare o rimuovere per questa esplorazione. Solo per BigQuery. Questo parametro può anche essere considerato un filtro. |
symmetric_aggregates |
Esplora | Specifica se gli aggregati simmetrici sono abilitati per un'esplorazione. Questo parametro è elencato anche per i parametri che influiscono sui valori di misurazione. |
Parametri da evitare
Poiché potresti visualizzare i seguenti parametri nel modello, abbiamo incluso un elenco di tali operazioni. Tuttavia, se aggiungi nuovi modelli, evita questi parametri.
Nome parametro | Livello | Descrizione |
---|---|---|
access_filter_fields |
Esplora |
RIMOSSO 6.0
Sostituito da access_filter |
decimals
|
Campi: D M |
RIMOSSO 5.4
Sostituito da value_format
|
distkey |
View (Visualizzazione) |
RIMOSSO 3.26
Sostituito da distribution |
format
|
Campi: D M |
RIMOSSO 3.16
Sostituito da value_format |
scoping |
Modello | RIMOSSO 3.52 Non più richiesto |
sql |
Partecipa |
EVITA 3.10
Sostituita da una combinazione di sql_on , foreign_key , type e/o sql_table_name , come descritto nella pagina della documentazione del parametro sql (for join)
|
sql_foreign_key |
Partecipa |
EVITA 3.16
Sostituito da foreign_key |
template |
Modello | RIMOSSO 3.30 Non più richiesto |
view_label |
View (Visualizzazione) |
EVITA 4.4
Sostituito da label |
Altri tutorial e risorse
Queste sezioni offrono link a risorse aggiuntive che possono approfondire la tua comprensione di LookML e supportarti in altre attività di sviluppo in Looker.
Comprendere il processo di sviluppo
La sezione Creazione di dati del menu della documentazione di Looker è progettata per consentirti di iniziare nella sezione Sviluppo di Looker.
Pagine specifiche che potrebbero essere utili da esaminare:
- Modalità di sviluppo e Modalità di produzione
- Accedere e modificare le informazioni del progetto
- Tutorial video per sviluppatori
Informazioni su LookML
La sezione Steps to learning LookML del menu della documentazione di Looker è progettata per presentare i concetti di base di LookML e suggerire un percorso di apprendimento verso la competenza in LookML.
Pagine specifiche che potrebbero essere utili da esaminare:
Creazione di dashboard LookML
Tutti i file di una dashboard in un progetto contengono parametri LookML specifici della dashboard. La pagina corrente include solo parametri di modellazione dei dati, non parametri della dashboard, ma la sezione Creazione e gestione delle dashboard di LookML del menu della documentazione di Looker è progettata per introdurre l'utilizzo delle dashboard di LookML.
Pagine specifiche che potrebbero essere utili da esaminare:
- Creazione di dashboard LookML
- Parametri della dashboard per i parametri che interessano un'intera dashboard
- Parametri degli elementi della dashboard per parametri che interessano elementi specifici di una dashboard.
Opzioni di incorporamento, API e amministrazione
Incorporamento
Le seguenti pagine potrebbero essere utili per scoprire di più sull'incorporamento di Look, esplorazioni e dashboard:
- Incorporamento pubblico con tag
iframe
- Incorporamento privato
- Incorporamento SSO
- Eventi JavaScript incorporati
API
La sezione API Looker del menu della documentazione di Looker è progettata per consentirti di iniziare a utilizzare l'interfaccia di programmazione dell'applicazione (API) sicura di Looker.
Opzioni amministratore
La sezione Getting started with admin options (Opzioni di amministrazione con le opzioni amministrative) del menu della documentazione di Looker è progettata per consentirti di iniziare nella sezione Admin (Amministrazione) di Looker.
Addestramento su Looker Connect
Registrati al nostro percorso di apprendimento per gli sviluppatori LookML su Looker Connect.