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 jeder 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 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

  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 diesen Explore erweitert werden
extension (für Explore) Gibt an, dass der Explore erweitert werden muss und 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 übergeben werden kann
Anzeigeparameter
description (für Explore) Fügt eine Beschreibung für einen 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 einen 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 ein Nutzer ändern, aber nicht entfernen kann
case_sensitive (für Explore) 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 der HAVING-Klausel der Abfrage Bedingungen hinzu, die ein Nutzer für diesen Explore nicht ändern oder entfernen kann
sql_always_where Fügt der WHERE-Klausel der Abfrage Bedingungen hinzu, die ein Nutzer für diesen Explore nicht ändern oder entfernen kann
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 Bricht die GROUP BY-Klausel ab, wenn bestimmte Felder in einem Explore ausgewählt werden
from (für Explore) Gibt die Ansicht an, auf der ein Explore basiert, und verweist über den Namen des Explores auf die Felder dieser Ansicht
persist_for (für Explore) Ändert die Cache-Einstellungen für einen Explore
persist_with (für Explore) Gibt die Datengruppe an, die für die Richtlinie für die Zwischenspeicherung des Explores verwendet werden soll
required_access_grants (für Explore) Beschränkt den Zugriff auf den Explore auf 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 symmetrische Aggregate für einen Explore aktiviert sind
view_name (für Explore) Gibt die Ansicht an, auf der ein Explore basiert, und verweist über den Namen der Ansicht auf die Felder dieser Ansicht
Parameter für aggregierte Tabellen
aggregate_table Erstellt eine aggregierte Tabelle, um die Aggregaterkennung für Abfragen für den 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 vor einem vorhandenen Explore-Namen ein Pluszeichen (+) 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 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