always_filter

שימוש

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}
היררכיה
always_filter
ערך ברירת המחדל
ללא

מקבלים
שם שדה וביטוי סינון ב-Looker

הגדרה

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

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

אם אתם רוצים שלניתוח יהיו מסננים שאי אפשר לשנות או להסיר, השתמשו באחד מהפרמטרים הבאים:

  • כדי להגדיר מסננים שיהיו זהים לכולם ושאי אפשר לראות או לשנות אותם בשום צורה, אתם יכולים להשתמש ב-sql_always_where.
  • כדי להגדיר מסננים שספציפיים לכל משתמש, ושאי אפשר לראות או לשנות אותם בשום צורה, אתם יכולים להשתמש ב-access_filter.

בפרמטר always_filter, השדה שאליו מפנה תת-הפרמטר filters יכול להיות מאפיין, מדד, מסנן או פרמטר. אם צריך להפנות למאפיין או למדד שהם חלק מתצוגה מצורפת ולא חלק מה-Explore הזה, משתמשים ב-view_name.field_name. לדוגמה:

explore: order {
  always_filter: {
    filters: [id: "123", customer.id: "789"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

כאן המסנן id מתייחס לשדה id מ-order. המסנן customer.id מתייחס לשדה id מ-customer. הדוגמה הזו גם ממחישה שאפשר להוסיף כמה מסננים.

לכל צמד field_name: "filter expression", ביטוי המסנן יכול להיות ערך מוחלט או ביטוי מסנן של Looker, בהתאם לסוג השדה שאתם מסננים.

דוגמאות

מגדירים מסנן ברירת מחדל ל-Explore בשדה מזהה הזמנה (עם ערך ברירת המחדל "123"):

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

מגדירים מסנן ברירת מחדל ל-Explore בשדה Order Created Date (עם ערך ברירת מחדל של שבעת הימים הקודמים) ובשדה הבוליאני (type: yesno) Is Complete (עם ערך ברירת מחדל תלוי אותיות רישיות של "No"):

explore: order {
  always_filter: {
    filters: [created_date: "7 days", is_complete: "No"]
  }
}

מגדירים מסנן ברירת מחדל ל-Explore בשדה מזהה הזמנה (ערך ברירת המחדל הוא "123"), בשדה Order City (ערך ברירת המחדל הוא "Chicago") ובשדה Customer Age (ערך ברירת המחדל הוא גדול מ-18 או שווה ל-18):

explore: order {
  always_filter: {
    filters: [id: "123", city: "Chicago", customer.age: ">=18"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

מה כדאי לקחת בחשבון?

ערכי סינון בוליאניים ב-always_filter הם תלויי אותיות רישיות

כשמסננים לפי שדה type: yesno בפרמטר always_filter, ביטוי המסנן הבוליאני תלוי אותיות רישיות (case-sensitive) וחייב להיות באותיות רישיות ("Yes" או "No"). זה שונה מתת-הפרמטר filters למדדים, שלא תלוי אותיות רישיות לערכים בוליאניים.

המשתמשים לא יכולים להסיר מסנן שצוין על ידי always_filter

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

הגדרת ערך ברירת מחדל ריק

אם רוצים ליצור מסנן ברירת מחדל עם ערך ברירת מחדל ריק, אפשר לעשות את זה על ידי ציון "-EMPTY" בערכי המסנן:

always_filter: {
  filters: [products.category: "-EMPTY"]
}

הפרמטר always_filter מבטל את הגדרת המסנן default_value

הפרמטר always_filter מבטל את ההגדרה default_value של השדה. אם תצהירו על ערך באמצעות always_filter, הערך הזה יהיה ברירת המחדל בכלי הניתוחים. אם לא תצהירו על ערך באמצעות always_filter, אז "is any value" יהיה המסנן שמוגדר כברירת מחדל ב-Explore.

always_filter משפיע על טבלאות Look ומשבצות קיימות בלוח הבקרה

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