datatype

用量

view: view_name {
  dimension: order_date {
    datatype: date
  }
}
階層
view
欄位類型
datatype
可能的欄位類型
維度、維度群組、篩選器、指標

預設值
timestamp
接受
其中一個可能值

定義

datatype 參數可讓您指定資料庫表格中提供給維度、dimension_group、篩選器或指標欄位的時間或日期資料類型。將資料類型與欄位相符，可提升查詢效能。

對於含有日期或時間資料的維度、篩選器和指標，以及含有 type: time 的維度群組，datatype 參數會套用至維度群組的 sql 參數。

如果是含有 type: duration 的維度群組，datatype 參數會同時套用至 sql_start 和 sql_end 參數，因此請務必確認 sql_start 和 sql_end 都是指定的資料類型。

datatype 參數接受下列值：

  • epoch - SQL Epoch 欄位 (即代表 Unix Epoch 紀元時間起算秒數的整數)
  • date - SQL 日期欄位 (即不含時間資訊的欄位)
  • datetime - SQL datetime 欄位
  • 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