full_suggestions

Nutzung

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
Hierarchie
view
Feldtyp
full_suggestions
Mögliche Feldtypen
Dimension, Dimensionsgruppe, Filter, Parameter

Akzeptiert
Ein boolescher Wert („Ja“ oder „Nein“)

Definition

Wenn ein Nutzer ein Explore nach einem Feldtyp filtert, der Vorschläge unterstützt, schlägt Looker standardmäßig mögliche Werte für das Feld vor. Informationen dazu, wie Sie Filtervorschläge beeinflussen können, finden Sie auf der Dokumentationsseite Filtervorschläge ändern. Um Vorschläge für ein Filterfeld zu machen, führt Looker eine Abfrage für Ihre Datenbank aus, um eine Liste mit eindeutigen Werten für das Feld abzurufen. Looker generiert diese Vorschläge in der Regel, indem eine Abfrage wie die folgende für das Filterfeld ausgeführt wird:

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

Mit dem Parameter full_suggestions wird gesteuert, wie Looker Ihre Datenbank abfragt, um Vorschläge für die Werte des Felds im Filter eines Explores zu machen:

  • full_suggestions: no: Looker verwendet die typische Abfrage für Filtervorschläge und fragt nur die Ansicht ab, die das Filterfeld enthält.

  • full_suggestions: yes: Looker fügt der Abfrage für Filtervorschläge die Explore-Logik hinzu. Das bedeutet, dass Looker alle Joins des Explores einbezieht, die zum Abfragen des Filterfelds erforderlich sind, sowie die Logik aus den Parametern des Explores, einschließlich der folgenden Parameter:

Standardverhalten

Wenn der Parameter full_suggestions für ein Feld nicht angegeben ist, werden Vorschlagswerte in Looker mit dem folgenden Verhalten abgefragt:

  • Bei Explores, in denen sql_always_where, access_filter oder always_join verwendet wird, wird in Looker standardmäßig das full_suggestions: yes-Verhalten verwendet. Da die Parameter access_filter, sql_always_where und always_join Einschränkungen für Explore-Abfragen festlegen, werden dieselben Einschränkungen auch auf die Abfragen für Filtervorschläge angewendet. Weitere Informationen dazu, wie Looker Vorschläge für Explores mit Abfragebeschränkungen bereitstellt, finden Sie unter Hinweise zu Explores mit sql_always_where oder access_filter.
  • Andernfalls wird in Looker standardmäßig das Verhalten von full_suggestions: no verwendet. Es wird nur die Ansicht des Filterfelds abgefragt und die Logik des Explores wird nicht berücksichtigt. Die Einstellung full_suggestions: no macht Filtervorschläge leistungsfähiger, da Looker eine einzelne Tabelle ohne Joins abfragt, ohne die im Explore definierte Logik zu verwenden.

Beispiel

Wenn Sie Looker auffordern möchten, die Logik des Explores zu verwenden, um Ihre Datenbank abzufragen, wenn Filtervorschläge für eine Dimension bereitgestellt werden, fügen Sie der Dimensionsdefinition full_suggestions: yes hinzu:

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

Wichtige Überlegungen zu Explores mit sql_always_where oder access_filter

Die Parameter sql_always_where und access_filter werden häufig verwendet, um den Datenzugriff zu steuern. Wenn sql_always_where oder access_filter für ein Explore verwendet werden, wendet Looker diese Einschränkungen auf die Filtervorschläge an, die für Feldtypen, die Vorschläge unterstützen, gemacht werden. Damit Nutzer keine Filtervorschläge sehen, die nicht auf sie zutreffen, muss die Explore-Logik (full_suggestions:yes) auf die Vorschläge für Filterwerte im Explore angewendet werden. Wenn ein Explore mit sql_always_where oder access_filter definiert ist, werden in Looker daher keine Vorschläge für einen Filter für ein Feld angezeigt, das mit full_suggestions:no definiert ist.

Wenn Sie einen Explore mit sql_always_where oder access_filter haben und ein Feld vorhanden ist, für das die Logik von sql_always_where oder access_filter nicht erforderlich ist, können Sie das Verhalten überschreiben, indem Sie der Definition des Felds bypass_suggest_restrictions:yes hinzufügen. Mit der bypass_suggest_restrictions:yes-Anweisung wird Looker aufgefordert, die vollständige Liste der Vorschläge für Filterwerte bereitzustellen.