query

Auf dieser Seite wird auf den Parameter query verwiesen, der Teil einer Exploration ist.

query kann auch als Teil einer Aggregattabelle verwendet werden, wie auf der Dokumentationsseite zum Parameter aggregate_table beschrieben.

Nutzung

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
Hierarchie
explore
query
Standardwert
Keine

Akzeptiert
Der Name der Abfrage und der Unterparameter zur Definition der Abfrage

Definition

Mit dem Parameter query können Sie modellierte Analysen für einen Explore erstellen. Die modellierten Analysen werden in einem leeren Explore im Bereich Schnellstart oder im Schnellstart-Pop-up angezeigt, nachdem ein Explore bereits ausgeführt wurde. Wie das funktioniert, sehen Sie im Abschnitt Beispiel auf dieser Seite.

Modellierte Analysen sind für Looker-Anfänger hilfreich, da Sie Elemente wie die Dimensionen, Messwerte, Filter und Pivots angeben können, die am relevantesten und aussagekräftigsten sein könnten.

Abfrage in LookML definieren

Anstatt das LookML für die Abfrage von Grund auf neu zu erstellen, können Sie ein Explore verwenden, um das Basis-LookML für die Abfrage zu erstellen. Weitere Informationen finden Sie im nächsten Abschnitt LookML für Abfragen aus einem Explore abrufen.

Der Parameter query hat die folgenden Unterparameter:

Parametername Beschreibung Beispiel
label Fügt optional ein Label für die query hinzu. Das Label wird in der Feldauswahl von Explore für die Abfrage angezeigt. label: "Weekly Sales Totals"
description Optional: Fügen Sie eine Beschreibung für diese Abfrage hinzu, um Ihre Nutzer zu informieren. In der Explore-Ansicht wird für alle Abfragen mit einer Beschreibung ein Infosymbol angezeigt. Der Beschreibungstext wird angezeigt, wenn ein Nutzer den Mauszeiger auf das Infosymbol bewegt. description: "Total value of all sales per day"
dimensions Eine durch Kommas getrennte Liste der Dimensionen aus dem Analysetool, die in Ihre Abfrage aufgenommen werden sollen. Das Feld dimensions verwendet diese Syntax:

dimensions: [dimension1, dimension2, ...] 		dimensions:

  [orders.created_month, orders.country]
measures Eine durch Kommas getrennte Liste der Messwerte aus dem Explore-Bericht, die in Ihre Abfrage aufgenommen werden sollen. Das Feld measures verwendet diese Syntax:

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters Fügt optional Filter zu einem query hinzu. Filter werden der WHERE-Anweisung des SQL-Codes hinzugefügt, mit dem die Abfrage generiert wird.

Das Feld filters verwendet diese Syntax:

filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit Gibt optional die Zeilenbegrenzung der Abfrage an. limit: 10
sorts Gibt optional Sortierfelder und die Sortierrichtung (aufsteigend oder absteigend) für query an.

Das Feld sorts verwendet diese Syntax:

sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots Die Ergebnisse werden optional anhand der angegebenen Dimensionen der Abfrage pivotiert. Das Feld pivots verwendet diese Syntax:

pivots: [dimension1, dimension2, ...]

NOTE: Die im Parameter pivots angegebenen Felder müssen auch im Parameter dimensions der Abfrage angegeben werden. 		pivots: [created_quarter]
timezone Nicht unterstützt Der Parameter timezone wird für den Parameter query nicht unterstützt, der ein Unterparameter von explore ist. Für ein query unter explore wird dieselbe Zeitzone wie für das explore verwendet.

LookML für Abfragen aus einem Explore abrufen

Als Abkürzung können Looker-Entwickler die Funktion zum Generieren von aggregate_table-LookML aus einem Explore verwenden, dann das LookML für die Abfrage der aggregierten Tabelle kopieren und als Ausgangspunkt für das LookML für die modellierte Analyse verwenden.

Wenn Sie die LookML für eine zusammengefasste Tabelle kopieren, werden auch einige Parameter kopiert, die Sie für die LookML Ihrer modellierten Abfrage nicht benötigen. Nachdem Sie die LookML für die zusammengefasste Tabelle kopiert haben, müssen Sie die Parameter aggregate_table und materialization löschen, da sie nur für zusammengefasste Tabellen gelten. Weitere Informationen zu diesen Parametern finden Sie auf der Dokumentationsseite zum Parameter aggregate_table.

Außerdem unterstützt der Parameter query der Aggregattabelle nur eine Teilmenge der Parameter, die von modellierten Explore-Abfragen unterstützt werden. Das bedeutet, dass Sie nach dem Kopieren des LookML für die zusammengefasste Tabelle query zusätzliche Parameter für Ihre modellierte Abfrage verwenden können. Eine vollständige Liste der Parameter, die für modellierte Abfragen unterstützt werden, finden Sie auf dieser Seite im Abschnitt Abfrage in LookML definieren.

So verwenden Sie ein Explore als Grundlage für das LookML Ihrer modellierten Abfrage:

  1. Wählen Sie in Ihrem Explore alle Felder und Filter aus, die in die modellierte Abfrage aufgenommen werden sollen.
  2. Klicken Sie auf Ausführen, um die Ergebnisse zu erhalten.

  3. Wählen Sie im Zahnradmenü „Explore-Aktionen“ die Option LookML abrufen aus. Diese Option ist nur für Looker-Entwickler verfügbar.

  4. Wählen Sie den Tab Aggregierte Tabelle aus.

  5. Looker stellt den LookML-Code für eine Verfeinerung eines Explores für eine aggregierte Tabelle bereit. Wir können das query-LookML der aggregierten Tabelle verwenden und für eine modellierte Explore-Abfrage anpassen. Kopieren Sie den LookML-Code und fügen Sie ihn in die zugehörige Modelldatei ein, die im Kommentar vor dem Explore-Refinement angegeben ist. Wenn das Explore in einer separaten Explore-Datei und nicht in einer Modelldatei definiert ist, können Sie die Verfeinerung der Datei des Explore anstelle der Modelldatei hinzufügen.

    Hier können Sie die LookML der aggregierten Tabelle ändern, die für eine modellierte Abfrage verwendet werden soll:

  6. Behalten Sie nur den Parameter query und seine Unterparameter bei. Löschen Sie die Parameter aggregate_table und materialization, da sie nur für aggregierte Tabellen gelten.

  7. Geben Sie einen Namen für die Abfrage ein. Wie im Beispiel auf dieser Seite gezeigt, lautet die Syntax so:

    query: query_name

  8. Optional: Geben Sie zusätzliche Parameter für die modellierte Abfrage ein. Eine vollständige Liste der Parameter, die für modellierte Abfragen unterstützt werden, finden Sie auf dieser Seite im Abschnitt Abfrage in LookML definieren.

Beispiel

In diesem Beispiel wird eine order_count_by_month-Abfrage für das Explore order_items erstellt:


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

Nutzer können die Schnellstart-Analyse im Bereich Schnellstart des Explorers Bestellpositionen ausführen.