数据类型

用量

视图：view_name {
dimension: order_date {
datatype: date
}
}
层次结构
view
字段类型
datatype
可能的字段类型
维度、维度组、过滤条件、衡量

默认值
timestamp
接受
几个可能的值之一

定义

借助 datatype 参数，您可以指定要在维度、维度组、过滤条件或衡量字段中提供的数据库表格中的时间或日期数据类型。将数据类型与字段匹配可以提高查询性能。

对于维度、过滤条件和测量包含的日期或时间数据，对于包含 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