erweitert (für Aufrufe)

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ür extends beschrieben.

extends kann auch als Teil eines LookML-Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.

Nutzung

view: view_name {
erweitert: [view_name, view_name, ...]
}
Hierarchie
extends
Standardwert
Keine

Akzeptiert
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 einen extends-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:

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.