数据类型
大约 4 分钟
数据类型
基本数据类型
IoTDB 支持以下十种数据类型：
- BOOLEAN（布尔值）
- INT32（整型）
- INT64（长整型）
- FLOAT（单精度浮点数）
- DOUBLE（双精度浮点数）
- TEXT（长字符串）
- STRING（字符串）
- BLOB（大二进制对象）
- TIMESTAMP（时间戳）
- DATE（日期）
其中，STRING 和 TEXT 类型的区别在于，STRING 类型具有更多的统计信息，能够用于优化值过滤查询。TEXT 类型适合用于存储长字符串。
浮点数精度配置
对于 FLOAT 与 DOUBLE 类型的序列，如果编码方式采用 RLE或 TS_2DIFF，可以在创建序列时通过 MAX_POINT_NUMBER 属性指定浮点数的小数点后位数。
例如，
CREATE TIMESERIES root.vehicle.d0.s0 WITH DATATYPE=FLOAT, ENCODING=RLE, 'MAX_POINT_NUMBER'='2';
若不指定，系统会按照配置文件 iotdb-system.properties 中的 float_precision 项配置（默认为 2 位）。
数据类型兼容性
当写入数据的类型与序列注册的数据类型不一致时，
- 如果序列数据类型不兼容写入数据类型，系统会给出错误提示。
- 如果序列数据类型兼容写入数据类型，系统会进行数据类型的自动转换，将写入的数据类型更正为注册序列的类型。
各数据类型的兼容情况如下表所示：
| 序列数据类型 | 支持的写入数据类型 |
|---|---|
| BOOLEAN | BOOLEAN |
| INT32 | INT32 |
| INT64 | INT32 INT64 |
| FLOAT | INT32 FLOAT |
| DOUBLE | INT32 INT64 FLOAT DOUBLE |
| TEXT | TEXT |
时间戳类型
时间戳是一个数据到来的时间点，其中包括绝对时间戳和相对时间戳。
绝对时间戳
IOTDB 中绝对时间戳分为二种，一种为 LONG 类型，一种为 DATETIME 类型（包含 DATETIME-INPUT, DATETIME-DISPLAY 两个小类）。
在用户在输入时间戳时，可以使用 LONG 类型的时间戳或 DATETIME-INPUT 类型的时间戳，其中 DATETIME-INPUT 类型的时间戳支持格式如表所示：
DATETIME-INPUT 类型支持格式
| format |
|---|
| yyyy-MM-dd HH:mm:ss |
| yyyy/MM/dd HH:mm:ss |
| yyyy.MM.dd HH:mm:ss |
| yyyy-MM-dd HH:mm:ssZZ |
| yyyy/MM/dd HH:mm:ssZZ |
| yyyy.MM.dd HH:mm:ssZZ |
| yyyy/MM/dd HH:mm:ss.SSS |
| yyyy-MM-dd HH:mm:ss.SSS |
| yyyy.MM.dd HH:mm:ss.SSS |
| yyyy-MM-dd HH:mm:ss.SSSZZ |
| yyyy/MM/dd HH:mm:ss.SSSZZ |
| yyyy.MM.dd HH:mm:ss.SSSZZ |
| ISO8601 standard time format |
IoTDB 在显示时间戳时可以支持 LONG 类型以及 DATETIME-DISPLAY 类型，其中 DATETIME-DISPLAY 类型可以支持用户自定义时间格式。自定义时间格式的语法如表所示：
DATETIME-DISPLAY 自定义时间格式的语法
| Symbol | Meaning | Presentation | Examples |
|---|---|---|---|
| G | era | era | era |
| C | century of era (>=0) | number | 20 |
| Y | year of era (>=0) | year | 1996 |
| x | weekyear | year | 1996 |
| w | week of weekyear | number | 27 |
| e | day of week | number | 2 |
| E | day of week | text | Tuesday; Tue |
| y | year | year | 1996 |
| D | day of year | number | 189 |
| M | month of year | month | July; Jul; 07 |
| d | day of month | number | 10 |
| a | halfday of day | text | PM |
| K | hour of halfday (0~11) | number | 0 |
| h | clockhour of halfday (1~12) | number | 12 |
| H | hour of day (0~23) | number | 0 |
| k | clockhour of day (1~24) | number | 24 |
| m | minute of hour | number | 30 |
| s | second of minute | number | 55 |
| S | fraction of second | millis | 978 |
| z | time zone | text | Pacific Standard Time; PST |
| Z | time zone offset/id | zone | -0800; -08:00; America/Los_Angeles |
| ' | escape for text | delimiter | |
| '' | single quote | literal | ' |
相对时间戳
相对时间是指与服务器时间now()和DATETIME类型时间相差一定时间间隔的时间。
形式化定义为：
Duration = (Digit+ ('Y'|'MO'|'W'|'D'|'H'|'M'|'S'|'MS'|'US'|'NS'))+
RelativeTime = (now() | DATETIME) ((+|-) Duration)+
The syntax of the duration unit
| Symbol | Meaning | Presentation | Examples |
|---|---|---|---|
| y | year | 1y=365 days | 1y |
| mo | month | 1mo=30 days | 1mo |
| w | week | 1w=7 days | 1w |
| d | day | 1d=1 day | 1d |
| h | hour | 1h=3600 seconds | 1h |
| m | minute | 1m=60 seconds | 1m |
| s | second | 1s=1 second | 1s |
| ms | millisecond | 1ms=1000_000 nanoseconds | 1ms |
| us | microsecond | 1us=1000 nanoseconds | 1us |
| ns | nanosecond | 1ns=1 nanosecond | 1ns |
例子：
now() - 1d2h //比服务器时间早 1 天 2 小时的时间
now() - 1w //比服务器时间早 1 周的时间
注意：'+'和'-'的左右两边必须有空格