datatype

Usage

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

ערך ברירת המחדל
timestamp
מקבל
אחד מכמה ערכים אפשריים

הגדרה

הפרמטר datatype מאפשר לציין את סוג הנתונים של השעה או התאריך בטבלת מסד הנתונים שאתם מספקים לשדה dimension,‏ dimension_group,‏ filter או measure. התאמה של סוג הנתונים לשדה יכולה לשפר את הביצועים של השאילתה.

במאפיינים, במסננים ובמדדים שמכילים נתוני תאריך או שעה, ובקבוצות של מאפיינים עם type: time, הפרמטר datatype חל על הפרמטר sql של קבוצת המאפיינים.

במקרה של קבוצות מאפיינים עם type: duration, הפרמטר datatype חל גם על הפרמטרים sql_start וגם על הפרמטרים sql_end, לכן חשוב לוודא שגם sql_start וגם sql_end הם מאותו סוג נתונים שצוין.

הפרמטר datatype מקבל את הערכים הבאים:

  • epoch – שדה של ראשית זמן SQL (כלומר, מספר שלם שמייצג את מספר השניות מראשית זמן יוניקס)
  • date – שדה תאריך של SQL (כלומר, שדה שלא מכיל מידע על השעה ביום)
  • datetime – שדה של תאריך ושעה ב-SQL
  • timestamp – שדה חותמת זמן של SQL
  • yyyymmdd – שדה SQL שמכיל מספר שלם שמייצג תאריך בפורמט YYYYMMDD

ערך ברירת המחדל של datatype הוא timestamp.

דוגמה

יוצרים dimension_group לשדה תאריך. כדי לשפר את ביצועי השאילתות, מגדירים את datatype: לערך date.

dimension_group: order_date
  type: time
  timeframes: [date, week, month, year]
  datatype: date
  sql: ${TABLE}.order_date