שינוי ההצעות לסינון

בדף הזה מופיעה סקירה כללית של פרמטרים של LookML שמשפיעים על הצעות לסינון. בדף הזה מפורט כל פרמטר עם קישור לדף העיון המלא שלו ותיאור קצר של הפונקציה שלו.

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

כברירת מחדל, ב-Look או ב-Explore, כשמשתמש מזין ערך של מסנן עבור שדה שתומך בהצעות, Looker מציע אפשרויות שתואמות למה שהמשתמש מזין. בלוח בקרה, אם המסנן של לוח הבקרה מסנן שדה שתומך בהצעות, Looker מציע גם אפשרויות סינון. ההצעות האלה לסינון נוצרות באמצעות שאילתת SELECT DISTINCT בשדה, ולכן ההצעות יחזירו רק ערכים שתואמים לנתונים קיימים בשדה הזה:

הצעות לסינון מופיעות בתפריט נפתח שמוצג כשמשתמש בוחר את שדה ערך הסינון.

אם נתקלתם בהתנהגות לא צפויה ואתם צריכים לפתור בעיות בהצעות לסינון, כדאי לעיין בדף השיטות המומלצות בנושא פתרון בעיות נפוצות בהצעות לסינון.

סוגי השדות שתומכים בהצעות

‫Looker תומך בהצעות לערכים הבאים של type בשדות dimension,‏ dimension_group,‏ filter ו-parameter.

ערכים של מאפיין type שתומכים בהצעות:

ערך של קבוצת מאפיינים type שתומך בהצעות:

ערך המסנן type שתומך בהצעות:

  • type: string

ערכים של הפרמטר type שתומכים בהצעות:

הפעלה או השבתה של הצעות לסינון

בקטע הזה מפורטים הפרמטרים הבאים של LookML שמאפשרים להפעיל או להשבית הצעות לסינון:

suggestions (צפייה)

כברירת מחדל, כשמשתמש מסנן ניתוח ב-Explore בשדה שתומך בהצעות, Looker מציע ערכים אפשריים לשדה.

אפשר להגדיר תצוגה עם suggestions:no כדי להשבית את ההצעות לכל השדות בתצוגה.

suggestable (שדה)

כברירת מחדל, כשמשתמש מסנן ניתוח ב-Explore בשדה שתומך בהצעות, Looker מציע ערכים אפשריים לשדה.

כדי להשבית את ההצעות בשדה מסוים, אפשר להגדיר אותו באמצעות suggestable:no.

ערכים של הצעות לסינון

בקטע הזה מפורטים הפרמטרים הבאים של LookML שמאפשרים להגדיר או להגביל את הערכים שמוצגים בהצעות לסינון:

allowed_value (שדה)

‫allowed_value פועל עם פרמטר LookML‏ parameter. אם מפתח Looker מספק parameter שדה לסינון בלבד, אפשר להפנות לערכים שהמשתמשים הזינו או בחרו באמצעות משתנה Liquid ‏{% parameter %}. אפשר גם להשתמש ב-allowed_value כדי להגדיר רשימה של ערכים שהמשתמש יכול לבחור בשדה הפרמטר הזה.

לפרמטר allowed_value יש שני פרמטרים משניים: label ו-value. פרמטר המשנה label מציין את האפשרויות שיוצגו למשתמש בהצעות לסינון. פרמטר המשנה value מכיל את הערכים שמועברים למשתנה {% parameter %} Liquid.

לדוגמה, אפשר להגדיר פרמטר באופן הבא:

parameter: order_amount {
  type: string
  allowed_value: {
    label: "Less than $50"
    value:"< 50"
  }
  allowed_value: {
    label: "Between $50 and $100"
    value:"<= 100"
  }
  allowed_value: {
    label: "Over $100"
    value:"> 100"
  }
}

לאחר מכן, כשמשתמש מסנן לפי הפרמטר, הוא יכול לבחור מבין האפשרויות פחות מ-50 $, בין 50 $ל-100 $ ומעל 100 $.

מידע נוסף זמין בקטע הזה בדף העיון בנושא parameter.

bypass_suggest_restrictions (שדה)

‫bypass_suggest_restrictions מאפשרת הצעות לסינון במצבים שבהם הן מושבתות או מוגבלות. אם השתמשתם ב-sql_always_where או ב-access_filter כדי להגביל את השורות שהמשתמשים יכולים לראות, גם ב-Looker ההצעות לסינון יוגבלו לערכים בשורות המותרות. עם זאת, אם אתם בטוחים שאין ערכים אפשריים בשדה מסוים שיכולים לחשוף מידע רגיש, אתם יכולים להשתמש בbypass_suggest_restrictions כדי להחזיר את כל הצעות המסננים.

case (שדה)

‫case מאפשרת לכם להקצות תוצאות של מאפיין לקבוצות באמצעות לוגיקה של תנאים. ההגדרה הזו משפיעה על ההצעות לסינון, כי רק הערכים שמוגדרים בהצהרת case מוצגים כהצעות לסינון של המאפיין הזה.

אפשר להשתמש במאפיין שמוגדר בו case עם מסננים מקושרים, אם המאפיין משמש במסנן שמעדכן את המסנן השני. אי אפשר להשתמש במסנן שמתעדכן במאפיין שמשתמש ב-case.

full_suggestions (שדה)

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

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

בדף full_suggestions מופיע מידע על התנהגות ברירת המחדל של Looker לגבי הצעות ועל שיקולים לגבי ניתוחים עם sql_always_where או access_filter

‫suggest_dimension (שדה) ו-suggest_explore (שדה)

בדרך כלל, Looker יוצר הצעות לסינון על ידי הפעלת שאילתת SELECT DISTINCT בשדה המסנן. בטבלאות גדולות מסוימות, השאילתה הזו יכולה להיות איטית מדי או ליצור עומס גדול מדי על מסד הנתונים. אפשר להשתמש ב-suggest_dimension כדי ש-Looker יחפש מאפיין חלופי להצעות סינון, בשילוב עם suggest_explore אם המאפיין הזה נמצא ב-Explore אחר.

suggestions (שדה)

‫suggestions מאפשר להגדיר רשימה של ערכים אפשריים להצעות לסינון. האפשרות הזו שימושית אם אתם לא רוצים שערכי נתונים מסוימים בשדה יופיעו כהצעות, ואתם רוצים לציין רשימה מצומצמת יותר.

הצעות לסינון שמירה במטמון

בקטע הזה מתואר הפרמטר suggest_persist_for, שמאפשר להגדיר את משך הזמן שבו הצעות למסננים נשמרות במטמון.

אם רוצים להפחית את העומס על מסד הנתונים ומספר ערכי הנתונים בשדה גבוה מאוד, כדאי להשתמש בפרמטר כדי להשבית את הצעות המסננים בשדה. אם רוצים שהצעות למסננים יופיעו, כדאי להשתמש בפרמטר כדי להגביל את ערכי המסננים שנשלחים לשאילתה או להגדיר את האפשרויות המתאימות כקבועות.

suggest_persist_for (שדה)

כברירת מחדל, הצעות לסינון נשמרות במטמון למשך שש שעות, כך שמוצגת אותה רשימת הצעות למשך הזמן הזה. הפרמטר suggest_persist_for מאפשר לשנות את משך הזמן שבו הצעות למסננים נשמרות במטמון.