Diese Seite bezieht sich auf den Parameter
extends
, der Teil einer Ansicht ist.
extends
kann auch als Teil eines explorativen Analysetools verwendet werden, wie auf der Seite mit der Parameterdokumentation fürextends
beschrieben.
extends
kann auch als Teil eines LookML-Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.
Nutzung
erweitert: [view_name, view_name, ...]
}
Hierarchie
extends |
Standardwert
KeineAkzeptiert
Eckige Klammern mit einer durch Kommas getrennten Liste von Ansichtsnamen |
Definition
Mit dem Parameter extends
können Sie auf dem Inhalt und den Einstellungen einer anderen Ansichtsdatei aufbauen und die andere Ansichtsdatei als Ausgangspunkt verwenden. Bei Konflikten werden für die erweiterte Ansicht die eigenen Einstellungen verwendet und die Einstellungen der erweiterten Ansicht überschrieben. Weitere Informationen dazu, wie Looker dies tut, finden Sie unter Code mit Erweiterung wiederverwenden.
Sehen Sie sich die Such-ML-Verfeinerungen an.
Die Erweiterung einer Ansicht oder eines explorativen Analysetools ist ideal, wenn Sie mehrere Versionen der Ansicht oder des explorativen Analysetools verwenden möchten. Wenn Sie lediglich eine Datenansicht oder eine explorative Datenanalyse ändern möchten, ohne die darin enthaltene LookML-Datei zu bearbeiten, können Sie stattdessen einen Suchfilter verwenden. Sie können auch einenextends
-Parameter innerhalb eines Suchfilters verwenden. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Optimierungen.
Wenn Sie eine Ansicht erweitern, ist es wichtig, den Parameter sql_table_name
für die zu erweiternde Ansicht zu verwenden, sofern diese noch nicht vorhanden ist. Der Parameter sql_table_name
definiert die Tabelle in Ihrer Datenbank, die von einer Ansicht abgefragt wird. Der Standardwert einer Ansicht ist der Name der Ansicht. Wenn Sie sql_table_name
also noch nicht verwenden, geben Sie ihm einfach denselben Wert wie für den Ansichtsnamen.
Außerdem ist es wichtig, dass Sie in der neuen Ansichtsdatei den Parameter include
verwenden, um auf den Dateinamen der Ansicht zu verweisen, die Sie erweitern möchten.
Vermeiden Sie es, Datenansichten zu erweitern, die auf nichtflüchtigen abgeleiteten Tabellen (PDTs) basieren. Mit jeder Erweiterung eines PDT wird eine neue Kopie der Tabelle in Ihrer Datenbank erstellt. In diesem Fall können Sie stattdessen Such-ML-Verfeinerungen verwenden. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Optimierungen.
Beispiel
Hier ist eine Beispieldatei, die wir erweitern können. Die Ansicht hat den Namen looker_events
und der Dateiname ist events.view
.
Datei: events.view
view: looker_events {
sql_table_name: looker_db.events ;;
# The normal contents of the view follow
}
Jetzt erstellen wir eine neue Ansichtsdatei und definieren eine Ansicht, die die Ansicht looker_events
erweitert. In der neuen Datei müssen Sie den Parameter include
verwenden, um auf den Dateinamen der Ansicht zu verweisen, die Sie erweitern möchten:
Datei: 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
}
Außerdem haben wir einen neuen Messwert hinzugefügt, der zusätzlich zu allen Dimensionen und Messwerten, die in der erweiterten looker_events
-Ansicht definiert sind, in unserer neuen Datenansicht erscheint.
Metadaten zum Anzeigen von Erweiterungen für ein Objekt verwenden
Sie können in der Looker-IDE auf einen explore
- oder view
-Parameter klicken und das Metadatenfeld verwenden, um alle Erweiterungen des Objekts zu sehen oder um zu sehen, welches Objekt erweitert wird. Weitere Informationen finden Sie auf der Dokumentationsseite Metadaten für LookML-Objekte.
Wichtige Punkte
Einige Parameter sind additiv
Wenn das erweiterte Objekt in vielen Fällen denselben Parameter wie das erweiterte Objekt enthält, werden die Parameterwerte des erweiterten Objekts durch die Werte des erweiterten Objekts überschrieben.
Erweiterungen können für einige Parameter jedoch additiv sein. Das heißt, die Werte aus dem erweiterten Objekt werden in Verbindung mit den Werten des erweiterten Objekts verwendet.
Die folgenden Parameter sind additiv:
Für Dimensionen und Messwerte:
Für Aufrufe:
extends
(Sie können mehrereextends
verketten)
Im folgenden Beispiel hat die Ansicht carriers
eine Dimension name
mit einem Parameter 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"
}
}
}
Und hier ist die Ansicht carriers_extended
, die die Ansicht carriers
erweitert. Die Ansicht carriers_extended
hat auch eine Dimension name
mit unterschiedlichen Einstellungen im Parameter 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"
}
}
}
In der Ansicht carriers_extended
sind die beiden link
-Parameter additiv. Die Dimension name
enthält also beide Links. Die Dimension im Bereich „Erkunden“ sieht so aus:
Projekte mit Lokalisierung
Beachten Sie bei der Erweiterung eines Objekts, dass Lokalisierungsregeln auch für Ihre Erweiterungen gelten. Wenn Sie ein Objekt erweitern und dann neue Labels oder Beschreibungen definieren, sollten Sie Lokalisierungsdefinitionen in den Gebietsschema-Stringdateien Ihres Projekts angeben. Weitere Informationen finden Sie auf der Dokumentation zur Lokalisierung Ihres LookML-Modells.