הדף הזה מתייחס לפרמטר
suggestionsשהוא חלק ממאפיין, משדה מסנן או מפרמטר.אפשר גם להשתמש בפרמטר
suggestionsכחלק מתצוגה, כמו שמתואר בדף התיעוד של הפרמטרsuggestions(לתצוגות).
Usage
view: view_name {
dimension: field_name {
suggestions: ["suggestion string", "suggestion string", "…"]
}
}
|
היררכיה
suggestions |
סוגי שדות אפשריים
מאפיין, מסנן, פרמטר
אישור
מחרוזת או רשימה של מחרוזות
|
הגדרה
כשמשתמש מסנן ניתוח ב-Explore לפי סוג שדה שתומך בהצעות, כברירת מחדל Looker יציע ערכים אפשריים לשדה (במאמר שינוי הצעות לסינון מוסבר איך אפשר להשפיע על ההצעות לסינון). כדי לספק הצעות לשדה מסנן, Looker מריץ שאילתה במסד הנתונים כדי לאחזר רשימה של ערכים נפרדים בשדה. בדרך כלל, כדי ליצור את ההצעות האלה, Looker מריץ שאילתה כמו זו הבאה בשדה המסנן:
SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000
הפרמטר suggestions מאפשר להגדיר מראש את רשימת הערכים המוצעים עבור מאפיין, שדה סינון או פרמטר שיופיעו כשמישהו ישתמש בשדה הזה כדי לסנן שאילתה.
אם השדה נמצא בטבלה גדולה, יכול להיות שהשאילתה הזו תהיה איטית מדי או תיצור עומס גדול מדי על מסד הנתונים. במקום זאת, אפשר להשתמש בערך suggestions כדי להגדיר רשימה של ערכים אפשריים ברמת הקוד ולשפר את הביצועים.
הפרמטר suggestions שימושי גם כי הוא מאפשר לציין רשימה מצומצמת יותר אם לא רוצים שערכים מסוימים משדה יופיעו כהצעות.
דוגמאות
מחליפים את הצעות ברירת המחדל למאפיין colors ברשימה שמוגדרת בקוד:
dimension: colors {
type: string
sql: ${TABLE}.colors ;;
suggestions: ["red", "yellow", "blue"]
}