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 können 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 kurze Beschreibung zu sehen. Klicken Sie darauf, 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

  autogenerate_primary_keys: yes | no
  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 Explore) Gibt die Explores an, die durch dieses Explore erweitert werden
extension (für Explore) 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 Explore) Begrenzt die in der Basisansicht und über Explore-Joins in einem Explore verfügbaren Felder
tags (für Explore) Gibt Text an, der an andere Anwendungen weitergeleitet werden kann
Anzeigeparameter
description (für Explore) Fügt eine Beschreibung für ein Explore hinzu, die Nutzern in der Benutzeroberfläche angezeigt wird
group_label (für Explore) Erstellt ein Gruppenlabel, das als Überschrift im Menü „Explore“ verwendet werden soll
hidden (für Explore) Blendet ein Explore im Menü „Explore“ aus
label (für Explore) Ändert die Darstellung eines Explore im Menü „Explore“
query (für Explore) Erstellt eine vordefinierte Abfrage, die Nutzer im Menü „Schnellstart“ eines Explore auswählen können.
view_label (für Explore) 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 Explore) Gibt an, ob bei Filtern für ein Explore zwischen Groß- und Kleinschreibung unterschieden werden soll
conditionally_filter Fügt einem Explore Filter hinzu, wenn ein Benutzer keinen eigenen Filter aus einer spezifischen Liste hinzufügt
sql_always_having Fügt Bedingungen in die HAVING-Klausel der Abfrage ein, die Benutzer für dieses Explore nicht ändern oder entfernen können
sql_always_where Fügt Bedingungen in die WHERE-Klausel der Abfrage ein, die Benutzer für dieses Explore nicht ändern oder entfernen können
Join-Parameter
always_join Gibt an, welche Joins immer auf ein 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
autogenerate_primary_keys (für Explore) Aktiviert oder deaktiviert die automatische Generierung von Primärschlüsseln
cancel_grouping_fields Deaktiviert die Klausel GROUP BY, wenn bestimmte Felder in einem Explore ausgewählt wurden
from (für Explore) 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 Explore) Ändert die Cache-Einstellungen für ein Explore
persist_with (für Explore) Gibt die Datengruppe an, die für die Cache-Richtlinie des Explore verwendet werden soll
required_access_grants (für Explore) Beschränkt den Zugriff auf das Explore auf die Nutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen
sql_table_name (für Explore) Gibt die Datenbanktabelle an, auf der ein Explore basieren soll
symmetric_aggregates Gibt an, ob für ein Explore die Funktion für symmetrische Summen aktiviert ist
view_name (für Explore) 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 aggregierte Tabellen
aggregate_table Erstellt eine aggregierte Tabelle, um die Aggregaterkennung für Abfragen für das Explore zu verwenden. Informationen zum Parameter aggregate_table finden Sie auf der Seite zum Parameter aggregate_table. Eine Übersicht über die Aggregaterkennung finden Sie auf der Aggregaterkennung Dokumentationsseite.
query Definiert die Abfrage für die aggregierte Tabelle. Informationen zu query und den zugehörigen Unterparametern finden Sie auf der Seite zum Parameter aggregate_table.
materialization Definiert die Persistenzstrategie für die aggregierte Tabelle. Informationen zu materialization und den zugehörigen Unterparametern finden Sie auf der Seite zum Parameter aggregate_table.
Parameter für Verfeinerungen
explore: +explore_name Fügt ein Pluszeichen (+) vor einem vorhandenen Explore-Namen ein, um dem vorhandenen Explore eine Verfeinerung 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 das 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