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 纪元字段（即表示自 Unix 纪元以来的秒数的整数）
  • 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