הגדרה

Usage

view: view_name {
   set: set_name {
      fields: [field, field, …]
   }
}

היררכיה הצגת הקובץ view set

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

הגדרה

קבוצות יכולות להיות שימושיות כשמפנים אליהן הפניה בפרמטרים אחרים, כמו fields (לצירופים) ו-drill_fields (לשדות), שנדרשות להם רשימות של שדות.

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

בתוך הפרמטר set מוסיפים פרמטר fields ואז מפרטים את השדות, כמו בדוגמה הזו:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

קבוצות יכולות להכיל גם קבוצות אחרות. כדי להבדיל בין שם של קבוצה לבין שם של מאפיין או מדד, מוסיפים את התו *. לדוגמה:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

set: my_second_set {
  fields: [
    dimension_three,
    measure_two
  ]
}

set: my_third_set {
  fields: [
    my_first_set*,
    my_second_set*
  ]
}

קבוצת השדות שנקראת my_third_set תכלול את השדות הבאים:

• dimension_one
• another_view.dimension_two
• measure_one
• dimension_three
• measure_two

לבסוף, אפשר להשתמש בתו - כדי להחריג שדות. לדוגמה:

set: my_first_set {
  fields: [
    dimension_one,
    another_view.dimension_two,
    measure_one
  ]
}

set: my_second_set {
  fields: [
    dimension_three,
    measure_two
  ]
}

set: my_third_set {
  fields: [
    my_first_set*,
    my_second_set*
  ]
}

set: my_fourth_set {
  fields: [
    my_first_set*,
    -measure_one
  ]
}

קבוצת השדות שנקראת my_fourth_set תכלול את השדות הבאים:

• dimension_one
• another_view.dimension_two

דוגמאות

תכין לי סט בשם financial_data

set: financial_data {
  fields: [
    subtotal,
    shipping,
    tax,
    total,
    cost,
    profit
  ]
}

יוצרים קבוצה בשם basic_customer_data בתצוגה Customers, שמפנה גם לתצוגה Customer Order Facts:

set: basic_customer_data {
  fields: [
    name,
    address,
    status,
    customer_order_facts.lifetime_orders,
    customer_order_facts.lifetime_revenue
  ]
}

אתגרים נפוצים

צריך לצרף שדות מתצוגה אחרת לניתוח שבו נעשה שימוש ב-set

אם רוצים להפנות לשדה ב-set שמגיע מתצוגה אחרת, צריך לוודא שהתצוגה הזו מצורפת לניתוח שבו נעשה שימוש ב-set. לדוגמה, הפעולה הבאה לא תעבוד:

קובץ מודל

explore: orders { ... }

הצגת הקובץ

view: orders {
  set: customer_info {
    fields: [customer.name]
  }
}

במקרה הזה, customers לא צורף ל-orders, ולכן אי אפשר להפנות לשדה מ-customers בקבוצת customer_info.

הוספת שדות מ-dimension_group לקבוצה

כשרוצים להוסיף שדות מ-dimension_group לקבוצה, צריך להוסיף כל מאפיין של מסגרת זמן בנפרד. לדוגמה, dimension_group:

dimension_group: created {
  type: time
  timeframes: [date, week, month]
  sql: ${TABLE}.created_at ;;
}

אי אפשר להוסיף את המאפיינים 'יום', 'שבוע' ו'חודש' לקבוצה כזו:

set: created_timeframes {
  fields: [created]
}

במקום זאת, תצטרכו להוסיף את מסגרות הזמן בנפרד, כך:

set: created_timeframes {
  fields: [
    created_date,
    created_week,
    created_month
  ]
}