full_suggestions

Usage

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
היררכיה
view
סוג השדה
full_suggestions
סוגי שדות אפשריים
מאפיין, קבוצת מאפיינים, מסנן, פרמטר

אישור
ערך בוליאני (yes או no)

הגדרה

כשמשתמש מסנן ניתוח ב-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

הפרמטר full_suggestions קובע איך Looker שולח שאילתות למסד הנתונים כדי לספק הצעות לערכים של השדה במסנן של כלי הניתוח:

  • ‫full_suggestions: no: ‏ Looker ישתמש בשאילתת ההצעות הרגילה למסננים, ויבצע שאילתה רק בתצוגה שמכילה את שדה המסנן.

  • ‫full_suggestions: yes: ‏ Looker יוסיף את הלוגיקה של ה-Explore לשאילתת הצעת המסנן שלו, כלומר Looker יכלול את כל שאילתות האיחוד (join) של ה-Explore שנדרשות לשאילתת השדה של המסנן, ו-Looker יכלול את הלוגיקה מהפרמטרים של ה-Explore, כולל הפרמטרים הבאים:

התנהגות ברירת מחדל

אם לא מציינים את הפרמטר full_suggestions בשדה, Looker מבצע שאילתות כדי להציע ערכים עם ההתנהגות הבאה:

  • ב-Explores שמשתמשים ב-sql_always_where או ב-access_filter, או ב-always_join, ברירת המחדל של Looker היא התנהגות full_suggestions: yes. הפרמטרים access_filter, sql_always_where ו-always_join מגבילים את השאילתות בכלי הניתוחים, ולכן אותן מגבלות חלות גם על השאילתות של הצעות הסינון. מידע נוסף על האופן שבו Looker מספק הצעות לניתוחים עם אילוצי שאילתות זמין במאמר שיקולים לגבי ניתוחים עם sql_always_where או access_filter.
  • אחרת, Looker יתנהג כפי שמוגדר ב-full_suggestions: no, כלומר ישלח שאילתה רק לתצוגה של שדה הסינון, בלי לכלול את הלוגיקה של הכלי'ניתוח נתונים'. ההגדרה full_suggestions: no משפרת את הביצועים של הצעות הסינון, כי Looker שולח שאילתה לטבלה אחת בלי לבצע איחודים ובלי להשתמש בלוגיקה שמוגדרת בכלי הניתוח.

דוגמה

כדי להנחות את Looker להשתמש בלוגיקה של הכלי'ניתוח נתונים' כדי לשלוח שאילתה למסד הנתונים כשמוצגות הצעות לסינון מאפיין, מוסיפים full_suggestions: yes להגדרה של המאפיין:

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

שיקולים לגבי חיפושים ב-Explore עם sql_always_where או access_filter

לרוב משתמשים בפרמטרים sql_always_where ו-access_filter כדי לשלוט בגישה לנתונים. בכל פעם שמשתמשים ב-sql_always_where או ב-access_filter ב-Explore, ‏ Looker מחיל את ההגבלות האלה על הצעות הסינון שהוא מציג עבור סוגי שדות שתומכים בהצעות. כדי למנוע ממשתמשים לראות הצעות לסינון שלא רלוונטיות להם, Looker דורש שהלוגיקה של הניתוח (full_suggestions:yes) תוחל על ההצעות לערכי סינון בניתוח. לכן, אם מוגדרת שאילתת Explore עם sql_always_where או access_filter, ‏ Looker לא יציע הצעות לסינון בשדה שמוגדר עם full_suggestions:no.

אם יש לכם Explore עם sql_always_where או access_filter, ויש לכם שדה שלא דורש את הלוגיקה של sql_always_where או access_filter, אתם יכולים לשנות את ההתנהגות על ידי הוספת bypass_suggest_restrictions:yes להגדרה של השדה. ההצהרה bypass_suggest_restrictions:yes גורמת ל-Looker לספק את הרשימה המלאה של הצעות לערכי מסננים.