order_by_field

Usage

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

מקבל
שם השדה

שימוש לא נכון ב-order_by_field עלול לגרום להתנהגות לא עקבית ומבלבלת אצל המשתמשים.

הגדרה

הפרמטר order_by_field מאפשר להשתמש בסדר המיון ממאפיין, מקבוצת מאפיינים או ממדד בשדה אחר מאותו סוג, במקום להשתמש בסדר המיון שמוגדר כברירת מחדל. השדות שאליהם מתייחס הפרמטר order_by_field חייבים להיות מאותו סוג כמו שדה האב. אי אפשר להפנות מאפיין לשדה של type: measure, ולהיפך.

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

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

אם יש רק status_id אחד לכל status_name, אפשר לכתוב:

dimension: status_name {
  sql: ${TABLE}.status_name ;;
  order_by_field: status_id
}

בעזרת מדדים, order_by_field מאפשר לכם להשתמש בסדר המיון ממדד אחד במדד אחר.

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

בדוגמה הזו, מחרוזת של ערים מסודרת לפי מדד count:

measure: user_cities {
  type: string
  order_by_field: count
}