Questa pagina si riferisce al parametro
extends
che fa parte di una vista.
extends
può essere utilizzato anche come parte di un'esplorazione, descritto nella pagina della documentazione relativa al parametroextends
(per le esplorazioni).
extends
può essere utilizzato anche come parte di una dashboard di LookML, come descritto nella pagina della documentazione Parametri della dashboard.
Utilizzo
estendi: [view_name, view_name, ...]
}
Gerarchia
extends |
Valore predefinito
NessunaAccetta
Parentesi quadre che contengono un elenco di nomi di viste separati da virgole |
Definizione
Il parametro extends
consente di utilizzare i contenuti e le impostazioni di un altro file di visualizzazione come punto di partenza, utilizzando l'altro file di visualizzazione. In caso di conflitti, la vista estesa utilizzerà le proprie impostazioni, sostituendo le impostazioni della vista estesa. Per informazioni dettagliate sulle modalità di esecuzione di Looker, vedi Riutilizzo di codice con estensioni.
Scopri i perfezionamenti di LookML.
L'estensione di una vista o di un'esplorazione è l'ideale per gli scenari in cui vuoi avere più versioni della vista o di un'esplorazione. Tuttavia, se il tuo obiettivo è semplicemente quello di modificare una vista o un'esplorazione senza modificare il file LookML che lo contiene, puoi utilizzare un perfezionamento. Puoi anche utilizzare un parametroextends
all'interno di un perfezionamento. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai perfezionamenti LookML.
Quando estendi una vista, è importante utilizzare il parametro sql_table_name
sulla vista che verrà estesa, se non è già presente. Il parametro sql_table_name
definisce la tabella nel database che viene sottoposta a query da una vista. Per qualsiasi vista, il valore predefinito è il nome della vista. Pertanto, se non stai già utilizzando sql_table_name
, ti basta assegnare lo stesso valore del nome della vista.
È anche importante che nel nuovo file di vista utilizziamo il parametro include
per puntare al nome file della vista che vuoi estendere.
Evita di estendere le visualizzazioni basate sulle tabelle derivate permanenti (PDT). Ogni estensione di una PDT creerà una nuova copia della tabella nel tuo database. In questo caso, ti consigliamo di utilizzare i perfezionamenti di LookML. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai perfezionamenti LookML.
Esempio
Ecco un file di esempio di esempio che possiamo estendere. Il nome della visualizzazione è looker_events
e events.view
.
File: events.view
view: looker_events {
sql_table_name: looker_db.events ;;
# The normal contents of the view follow
}
Ora creiamo un nuovo file di vista e definiamo una vista che estende la vista looker_events
. Nel nuovo file, dobbiamo utilizzare il parametro include
per puntare al nome del file della visualizzazione che vuoi estendere:
File: new_events.view
include: "events.view"
view: name_of_the_new_view {
extends: [looker_events]
measure: additional_measure {
type: count
}
# Additional things you want to add or change
}
Inoltre, abbiamo aggiunto una nuova misura che verrà mostrata nella nuova vista oltre a tutte le dimensioni e le misure definite nella vista looker_events
che abbiamo esteso.
Utilizzo dei metadati per visualizzare le estensioni per un oggetto
Puoi fare clic su un parametro explore
o view
nell'IDE di Looker e utilizzare il riquadro dei metadati per visualizzare le estensioni sull'oggetto o vedere quale oggetto si estende. Per informazioni, consulta la pagina Metadati degli oggetti LookML.
Aspetti da considerare
Alcuni parametri sono cumulativi
In molti casi, se l'oggetto in estensione contiene lo stesso parametro dell'oggetto in fase di estensione, i valori dell'oggetto che viene esteso sostituiscono quelli dell'oggetto esteso.
Tuttavia, alcune estensioni possono essere additive per alcuni parametri, il che significa che i valori dell'oggetto che esegue l'estensione vengono utilizzati insieme a quelli dell'oggetto esteso.
I seguenti parametri sono additive:
Per dimensioni e misure:
Per le visualizzazioni:
extends
(puoi connettere piùextends
)
Nell'esempio seguente, la vista carriers
ha una dimensione name
con un parametro link
:
view: carriers {
sql_table_name: flightstats.carriers ;;
dimension: name {
sql: ${TABLE}.name ;;
type: string
link: {
label: "Google {{ value }}"
url: "http://www.google.com/search?q={{ value }}"
icon_url: "http://google.com/favicon.ico"
}
}
}
Questa è la vista carriers_extended
, che estende la visualizzazione carriers
. La vista carriers_extended
ha anche una dimensione name
con impostazioni diverse nel parametro link
:
include: "/views/carriers.view.lkml"
view: carriers_extended {
extends: [carriers]
dimension: name {
sql: ${TABLE}.name ;;
type: string
link: {
label: "Dashboard for {{ value }}"
url: "https://docsexamples.dev.looker.com/dashboards/307?Carrier={{ value }}"
icon_url: "https://www.looker.com/favicon.ico"
}
}
}
Nella vista carriers_extended
, i due parametri link
sono cumulativi, quindi la dimensione name
avrà entrambi i link. La dimensione è simile a quella di un'esplorazione:
Progetti con localizzazione
Quando estendi un oggetto, tieni presente che le regole di localizzazione si applicano anche alle estensioni. Se estendi un oggetto e poi definisci nuove etichette o descrizioni, devi fornire le definizioni di localizzazione nei file di stringhe internazionali del tuo progetto. Per ulteriori informazioni, consulta la pagina Documentazione di Localizzazione del modello LookML.