erweitert (für „Erkunden“)

Diese Seite bezieht sich auf den Parameter extends, der Teil einer Erkunden ist.

extends kann auch als Teil einer Ansicht verwendet werden, wie auf der Dokumentationsseite zum Parameter extends (für Ansichten) beschrieben.

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

Nutzung

Explore: Explore-Name {
Verlängert: [explore_name, explore_name, ...]
}
Hierarchie
explore
extends
Standardwert
Keine

Akzeptiert
Eckige Klammern mit einer durch Kommas getrennten Liste der Namen von „Erkunden“

Definition

Mit dem Parameter extends können Sie auf dem Inhalt und den Einstellungen eines anderen Bereichs „Entdecken“ aufbauen und diesen anderen Ausgangspunkt verwenden. Wenn es widersprüchliche Daten gibt, werden für die Erweiterung „Entdecken“ ihre eigenen Einstellungen verwendet und die Einstellungen der entsprechenden Erweiterung überschrieben. Weitere Informationen dazu, wie Looker funktioniert, finden Sie auf der Dokumentationsseite Code mit extends 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 explorative Datenanalyse erweitern möchten, muss der Parameter view_name in der Erweiterung enthalten sein. Der Parameter view_name definiert die Ansicht, auf der eine explorative Datenanalyse basiert. Der Standardwert ist der Name der Funktion „Erkunden“. Wenn für die Basisanalyse kein view_name festgelegt ist, wird standardmäßig der Name „Entdecken“ verwendet. Das funktioniert jedoch nicht für andere explorative Datenanalysen, die die Basis-explorative Datenanalyse erweitern. Daher erhalten wir die Fehlermeldung „Unbekannte Ansicht“. Damit Looker die richtige Ansichtsdatei verwenden kann, müssen Sie sie mit dem Parameter view_name angeben. Da dies in jeder erweiterten Version der Funktion „Erkunden“ erforderlich ist, sollte sie der Basis-explorativen Datenanalyse hinzugefügt werden, damit immer dann darauf verwiesen wird, wenn die Erweiterung erweitert wird.

Wenn Ihre Basis-explorative Datenanalyse noch keinen view_name-Parameter hat, können Sie einfach den view_name-Parameter hinzufügen und denselben Wert wie für den Namen der Funktion angeben.

Sie können auch den Parameter view_label in Ihrer Basis verwenden und „Erkunden“ erweitern. Der Parameter view_label bestimmt das Label, unter dem die Felder der Ansicht in der Feldauswahl gruppiert werden. Ein Beispiel finden Sie auf der Dokumentationsseite für den Parameter view_label. Wenn Sie keinen view_label für Ihre Basis angeben und die Funktion „Erkunden“ erweitern, wird für beide der Name „Entdecken“ verwendet.

Beispiel

Hier sehen Sie ein Beispiel für die Funktion „Erkunden“ in der Modelldatei:

explore: orders {
  view_name: orders
  view_label: "Orders"
  # The normal contents of the Explore follow
}

Und hier fügen wir eine neue Erkundung hinzu, die die oben definierte Erkundung orders erweitert:

explore: name_of_the_new_explore {
  extends: [orders]
  view_label: "Order Information"
  # The additional things you want to add or change
  # in the new Explore
}

Wenn Sie eine Erkundung auf einer erweiterten Ansicht erweitern, müssen Sie auch den Parameter from verwenden. Fügen Sie from in der erweiterten explorativen Datenanalyse hinzu und weisen Sie ihr den Namen der erweiterten ed-Ansicht zu.

explore: new_explore {
  extends: [orders]
  from: extended_orders_view
  #The normal contents of the Explore follow
}

Mit extends Felder für verschiedene Nutzer einschränken

Ein sehr praktischer Anwendungsfall für die Erweiterung einer explorativen Datenanalyse ist, dass nur ein Teil der Felder der Funktion „Entdecken“ bestimmten Nutzern angezeigt wird. Angenommen, Sie haben die Funktion products „Erkunden“ mit allen verfügbaren Feldern aus den verknüpften Tabellen:

explore: products {
  view_name: products
  from: products
  join: inventory_items {
    type: left_outer
    sql_on: ${products.id}=${inventory_items.product_id} ;;
    relationship: many_to_one
  }

  join: order_items {
    type: left_outer
    sql_on: ${order_items.inventory_item_id}=${inventory_items.id} ;;
    relationship: one_to_one
  }
}

Wenn Sie ein Team haben, das nur die Produktkategorie und die Retouren sehen soll, können Sie den products-Parameter „Erkunden“ erweitern und mit dem Parameter fields festlegen, dass nur die Felder für Produktkategorie und Rückgaben eingeschlossen werden sollen:


explore: products_extended {
  extends: [products]
  fields: [products.category,order_items.returned_date]
}

In „Erkunden“ von products_extended werden nur diese beiden Felder angezeigt: products.category und order_items.returned_date.

Modelle auf mehrere Modelle anwenden

Explorative Datenanalysen werden normalerweise in einer Modelldatei definiert. Wenn Sie die Funktion „Erkunden“ erweitern möchten, können Sie sie wie in den Beispielen oben in derselben Modelldatei definieren.

Wenn Sie eine explorative Datenanalyse auf mehrere Modelle ausweiten möchten, müssen Sie jedoch eine separate explorative Datenanalysedatei erstellen, die als Basisdatei verwendet wird. Nachdem Sie die Basis-explorative Datenanalyse in einer eigenen Datei definiert haben, können Sie die Datei „Erkunden“ in Ihre Modelldatei einfügen und die Funktion „Entdecken“ in Ihrer Modelldatei erweitern.

Sie können eine Erkundungsdatei in eine andere Erkundungsdatei einfügen oder Ihre Basisdatei bei Bedarf für mehrere andere Dateien mit diesem Inhalt freigeben.

Dateien zum Entdecken werden der Verbindung des Modells angehört, in das sie eingeschlossen sind. Das sollten Sie berücksichtigen, wenn Sie Dateien zum Entdecken in Modelle einbinden, die mit einer Verbindung konfiguriert sind, die sich vom übergeordneten Modell der Datei „Erkunden“ unterscheidet. Wenn sich das Schema für die Verbindung des einschließenden Modells vom Schema der Verbindung des übergeordneten Modells unterscheidet, kann es zu Abfragefehlern kommen.

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 für „Erkunden“ sind additiv:

Im folgenden Beispiel verwendet der Parameter aircraft_base den Parameter join, um die Ansicht aircraft mit der Ansicht aircraft_types zu verknüpfen:


explore: aircraft {
  view_name: aircraft
  label: "Aircraft"

  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }
}

Und mit dem aircraft_extended Entdecken erweiterst du den Tab aircraft_base Entdecken. Darüber hinaus hat der Parameter aircraft_extended den Parameter join, der in der Ansicht aircraft_engine_types zusammengeführt wird:


explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

Der Parameter join ist additiv. Daher werden im Ergebnis des explorativen Analysetools die in der Basis-explorativen Ansicht zusammengeführten Ansichten und die in der erweiterten explorativen Datenanalyse zusammengeführten Ansichten angezeigt. In diesem Fall enthält die Ansicht „aircraft_extended“ die Ansichten aircraft, aircraft_types und aircraft_engine_types:

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.