Explore-Parameter

Auf dieser Seite finden Sie Links zu allen LookML-Parametern, die unter dem Parameter explore stehen.

Ein Explore dient als Ausgangspunkt für eine Abfrage in der Looker-Anwendung. Explores verweisen auf Ansichten und jedes Explore kann Joins zu anderen Ansichten enthalten. Explores sollten in der Regel in einer Modelldatei deklariert werden.

Nutzungsbeispiel

Bewegen Sie den Mauszeiger auf einen Parameternamen, um eine Kurzbeschreibung aufzurufen. Klicken Sie auf den Namen, um zur entsprechenden Seite zu springen. Wenn ein Parameter auf eine von mehreren bestimmten Optionen festgelegt werden kann, wird der Standardwert zuerst aufgeführt.

## STRUCTURAL PARAMETERS

explore: explore_name {
  extension: required
  extends: [explore_name,  explore_name, ...]
  fields: [field_or_set, field_or_set, ...]
  tags: ["string1", "string2", ...]

  # DISPLAY PARAMETERS
  description: "Description I want"
  group_label: "Label to use as a heading in the Explore menu"
  hidden: yes | no
  label: "desired label"
  query:  {
      # Desired query parameters (described on the query page)      }
  view_label: "Field picker heading I want for the Explore's fields"

  # FILTER PARAMETERS

  access_filter: {
    field: fully_scoped_field
    user_attribute: user_attribute_name
  }

  # Possibly more access_filter declarations

  always_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
  }
  case_sensitive: yes | no
  conditionally_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
    unless: [field_name, field_name, ...]
  }
  sql_always_having: SQL HAVING condition ;;
  sql_always_where: SQL WHERE condition ;;

  # JOIN PARAMETERS

  always_join: [view_name, view_name, ...]
  join: view_name {
    # Desired join parameters (described on Join Parameters page)
  }
  # Possibly more join declarations

  # QUERY PARAMETERS

  cancel_grouping_fields: [fully_scoped_field, fully_scoped_field, ...]
  from: view_name
  persist_for: "N (seconds | minutes | hours)"
  persist_with: datagroup_name
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;
  sql_preamble: SQL STATEMENT  ;;
  symmetric_aggregates: yes | no
  view_name: view_name

  # AGGREGATE TABLE PARAMETERS

  aggregate_table: table_name {
    query:  {
      # Desired query parameters (described on the aggregate_table page)
    }
    materialization:  {
      # Desired materialization parameters (described on the aggregate_table page)
    }
  }
  # Possibly more aggregate_table declarations
}

## REFINEMENT PARAMETERS

explore: +explore_name {
  final: yes
}

Parameterdefinitionen

Parametername Beschreibung
Strukturparameter
extends (für „Entdecken“) Gibt die Explores an, die durch dieses Explore erweitert werden.
extension (für „Entdecken“) Gibt an, dass für das Explore eine Erweiterung erforderlich ist und es selbst nicht für Nutzer verfügbar gemacht werden kann.
explore (für Modell) Zeigt eine Ansicht im Menü „Explore“ an.
fields (für „Entdecken“) Begrenzt die in der Basisansicht und über Explore-Joins in einem Explore verfügbaren Felder.
tags (für „Entdecken“) Gibt Text an, der an andere Anwendungen weitergeleitet werden kann
Parameter für die Anzeige
description (für „Entdecken“) Fügt eine Beschreibung für einen Explore hinzu, die Nutzern auf der Benutzeroberfläche angezeigt wird.
group_label (für „Entdecken“) Erstellt eine Gruppenbezeichnung, die als Überschrift im Menü „Explore“ verwendet werden soll.
hidden (für „Entdecken“) Blendet einen Explore im Menü „Explore“ aus.
label (für „Entdecken“) Ändert die Darstellung eines Explore im Menü „Explore“.
query (für „Entdecken“) Erstellt eine vordefinierte Abfrage, die Nutzer im Schnellstartmenü eines Explores auswählen können.
view_label (für „Entdecken“) Gibt an, wie eine Gruppe von Feldern aus der Explore-Basisansicht im Field Picker bezeichnet werden soll
Filterparameter
access_filter Fügt einem Explore benutzerspezifische Filter hinzu
always_filter Fügt einem Explore Filter hinzu, die Benutzer ändern, aber nicht entfernen können.
case_sensitive (für „Entdecken“) Gibt an, ob bei Filtern für einen Explore zwischen Groß- und Kleinschreibung unterschieden werden soll
conditionally_filter Fügt einem Explore Filter hinzu, wenn ein Nutzer keinen eigenen Filter aus einer bestimmten Liste hinzufügt.
sql_always_having Fügt Bedingungen in die HAVING-Klausel der Abfrage ein, die Benutzer für diesen Explore nicht ändern oder entfernen können.
sql_always_where Fügt Bedingungen in die WHERE-Klausel der Abfrage ein, die Benutzer für diesen Explore nicht ändern oder entfernen können.
Join-Parameter
always_join Gibt an, welche Joins immer auf einen Explore angewendet werden müssen
join Verbindet eine zusätzliche Ansicht mit einem Explore. Weitere Informationen zu Joins und den zugehörigen Parametern finden Sie auf der Referenzseite Join-Parameter.
Suchparameter
cancel_grouping_fields Deaktiviert die GROUP BY-Klausel, wenn bestimmte Felder in einem Explore ausgewählt werden
from (für „Entdecken“) Gibt die Ansicht an, auf der ein Explore basieren soll, und verweist unter Verwendung des Explore-Namens auf die Felder in dieser Ansicht
persist_for (für „Entdecken“) Ändert die Cache-Einstellungen für einen Explore
persist_with (für „Entdecken“) Gibt die Datengruppe an, die für die Richtlinie für die Zwischenspeicherung des Explores verwendet werden soll
required_access_grants (für „Entdecken“) Beschränkt den Zugriff auf den Explore auf die Nutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen
sql_table_name (für „Entdecken“) Gibt die Datenbanktabelle an, auf der ein Explore basieren soll
symmetric_aggregates Gibt an, ob für einen Explore die Funktion für symmetrische Summen aktiviert ist
view_name (für „Entdecken“) Gibt die Ansicht an, auf der ein Explore basieren soll, und verweist unter Verwendung des Namens der Ansicht auf die Felder in dieser Ansicht.
Parameter für zusammengefasste Tabellen
aggregate_table Erstellt eine aggregierte Tabelle, um Aggregate Awareness für Abfragen im Explore zu verwenden. Informationen zum Parameter aggregate_table finden Sie auf der Parameterseite aggregate_table. Einen Überblick über Aggregate Awareness finden Sie auf der Dokumentationsseite Aggregate Awareness.
query Definiert die Abfrage für die aggregierte Tabelle. Informationen zu query und seinen Unterparametern finden Sie auf der Parameterseite aggregate_table.
materialization Definiert die Persistenzstrategie für die Aggregattabelle. Informationen zu materialization und seinen Unterparametern finden Sie auf der Parameterseite aggregate_table.
Parameter für die Verfeinerung
explore: +explore_name Fügt ein Pluszeichen (+) vor einem vorhandenen Explore-Namen ein, um dem vorhandenen Explore ein Refinement hinzuzufügen. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Verfeinerungen.
final Gibt an, dass die aktuelle Verfeinerung die letzte zulässige Verfeinerung für den Explore ist. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Verfeinerungen.
Unzulässige Parameter
access_filter_fields Entfernt in Version 6.0 Ersetzt durch access_filter