Auf dieser Seite wird auf den Parameter
suggestionsverwiesen, der Teil einer Dimension, eines Filterfelds oder eines Parameters ist.Sie können
suggestionsauch als Teil einer Ansicht verwenden, wie auf der Dokumentationsseite zum Parametersuggestions(für Ansichten) beschrieben.
Nutzung
view: view_name {
dimension: field_name {
suggestions: ["suggestion string", "suggestion string", "…"]
}
}
|
Hierarchie
suggestions |
Mögliche Feldtypen
Dimension, Filter, Parameter
Akzeptiert
Ein String oder eine Liste von Strings
|
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 unter 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 suggestion können Sie die Liste der Vorschlagswerte für eine Dimension, ein Filterfeld oder einen Parameter fest codieren, die angezeigt werden, wenn ein Nutzer dieses Feld zum Filtern einer Abfrage verwendet.
Wenn sich das Feld in einer großen Tabelle befindet, kann diese Abfrage zu langsam sein oder eine zu hohe Datenbanklast verursachen. Mit suggestions können Sie stattdessen eine Liste möglicher Werte hartcodieren und die Leistung verbessern.
Der Parameter suggestions ist auch nützlich, weil Sie damit eine eingeschränktere Liste angeben können, wenn bestimmte Werte aus einem Feld nicht als Vorschläge angezeigt werden sollen.
Beispiele
Ersetzen Sie die Standardsuggestionen für die Dimension colors durch eine fest codierte Liste:
dimension: colors {
type: string
sql: ${TABLE}.colors ;;
suggestions: ["red", "yellow", "blue"]
}