always_filter

Usage

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}

היררכיה קובץ מודל explore always_filter

ערך ברירת המחדל ללא אישור שם שדה וביטוי סינון ב-Looker

הגדרה

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

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

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

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

בפרמטר always_filter, השדה שאליו מתבצעת ההפניה בתת-פרמטר filters יכול להיות מאפיין, מדד, מסנן או פרמטר. אם אתם צריכים להפנות למאפיין או למדד שכלולים בתצוגה משולבת ולא בניתוח הזה, צריך להשתמש ב-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, בהתאם לסוג השדה שמסננים.

דוגמאות

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

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

מגדירים מסנן ברירת מחדל לניתוח ב-Explore בשדה תאריך יצירת ההזמנה (עם ערך ברירת מחדל של שבעת הימים הקודמים):

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

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

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

דברים שכדאי לקחת בחשבון

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

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

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

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

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

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

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

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

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