数值、字符串、日期和时间

本文档主要介绍 YMatrix 支持的常用数据类型。

主要为如下三种类型:

  • 数值型
  • 字符串型
  • 日期和时间型

1 数值

YMatrix 支持的数值类型主要分 4 类:

  • 整数。不同整型数据拥有不同的取值范围,均带有正、负符号:
    1. smallint
    2. int
    3. bigint
  • 定点数。用于表示小数点位数固定的数据:
    1. decimal
  • 浮点数。用于表示小数点位数不固定的数据:
    1. real
    2. double precision
  • 自增类型。通常用于自增 ID 列:
    1. serial
    2. bigserial

具体信息如下:

类型 别名 大小 范围 说明
smallint int2 2 字节 -32768 ~ 32767 小范围整数
int int4 4 字节 -2147483648 ~ 2147483647 整数类型
bigint int8 8 字节 -9223372036854775808 ~ 9223372036854775807 大范围整数
serial serial4 4 字节 1 ~ 2147483647 自增型整数
bigserial serial8 8 字节 1 ~ 9223372036854775807 大范围自增型整数
real float4 4 字节 6 位精度 可变精度
double precision float8 8 字节 15 位精度 可变精度
decimal numeric 可变 无限制 固定精度

2 字符串

YMatrix 支持的字符串类型主要有 2 种:

  • 定长:char
  • 变长
    1. varchar:有长度限制
    2. text:无长度限制

具体信息如下:

类型 别名 大小 范围 说明
character [ (n) ] char [ (n) ] 1 字节 + n 最长 n 个字符的字符串 定长字符串,未指定的字符用空格填充
character varying [ (n) ] varchar [ (n) ] 1 字节 + 字符串大小 最长 n 个字符的字符串 有长度限制的变长字符串,上限 10485760 字节
text 1 字节 + 字符串长度 任意长度字符串 无长度限制的变长字符串

3 日期和时间

YMatrix 的日期时间类型主要为 3 种:

  • 日期。仅能表示年-月-日,表示不了时间:

    1. date
  • 时间。仅能表示时间,表示不了日期:

    1. time [without time zone](不带时区)
    2. time with time zone(带时区)
  • 日期和时间。既能表示日期又能表示时间:

    1. timestamp [without time zone](不带时区)
    2. timestamp with time zone(带时区)

具体信息如下:

类型 别名 大小 范围 说明
date 4 字节 4713 BC ~ 294,277 AD 日历日期 (年, 月, 日)
time [ (p) ] [ without time zone ] 8 字节 00:00:00[.000000] ~ 24:00:00[.000000] 一天内的时间
time [ (p) ] with time zone timetz 12 字节 00:00:00+1359 ~ 24:00:00-1359 一天内的时间, 带时区
timestamp [ (p) ] [ without time zone ] 8 字节 4713 BC ~ 294,277 AD 日期和时间
timestamp [ (p) ] with time zone timestamptz 8 字节 4713 BC ~ 294,277 AD 日期和时间, 带时区

3.1 时区对时间类型的影响

从时间类型中可以看到一个特殊信息:time zone,即时区。默认 without time zone,即无时区。那么时区是什么,对于时间类型又有什么影响呢?
你将通过创建一张测试表的过程来了解它。

=# CREATE TABLE test (
    c1 int,
    c2 timestamp,
    c3 timestamp with time zone
   )
   USING MARS3
   DISTRIBUTED BY (c1)
   ORDER BY (c1,c2);

测试表除了分布键外包含了两个时间戳列,一个默认不带时区,一个带时区。插入测试数据并查询:

=# INSERT INTO test VALUES(1, now(), now());

=# SELECT * FROM test;
 c1 |            c2            |             c3
----+--------------------------+-----------------------------
  1 | 2021-12-01 14:54:09.4783 | 2021-12-01 14:54:09.4783+08
(1 row)

=# SHOW timezone;
   TimeZone
---------------
 Asia/Shanghai
(1 row)

从查询结果可以看到,两个时间戳列显示的时间是一样,带时区的列后面有一个 +08,表示该时间戳所属时区为“东八区”。然后通过 SHOW timezone 命令看到了当前时区为 'Asia / Shanghai',即北京时间。

下面我们修改时区再查看结果:

=# SET timezone TO 'Japan';

=# SELECT * FROM test;
 c1 |            c2            |             c3
----+--------------------------+-----------------------------
  1 | 2021-12-01 14:54:09.4783 | 2021-12-01 15:54:09.4783+09
(1 row)

可以看到,当把数据库时区改到日本后,带时区的 c3 列显示的时间已经和 c2 不一样了,并且后面时区信息变成了 +09,即“东九区”。

综上,带时区的时间戳列存储的时间是有时区信息的,会在不同的时区下显示不同的时间;而不带时区的时间戳列则在任何时区下显示的时间都是相同的。当设备部署在不同时区的地域时,则时间戳必须要有时区信息。且对于 timestamp 类型有无时区占用存储空间都相同,何乐而不为?

3.2 时序场景下 常见数据类型最佳实践

时序场景数据分为如下几类:

  • 时间戳:表示指标采集时间。
  • 设备标识:每台设备的唯一标识。
  • 采集指标:从每台设备采集到的时序数据指标。

具体信息如下:

类型 描述 最佳实践
时间戳 表示指标采集时间。包括日期及具体时间 timestamp with time zone
设备标识 字符串标识 varchar / text
设备标识 定长的设备编号信息,如序列号 char
设备标识 单独创建设备表,以自增 ID 来唯一标识设备 serial / bigserial
采集指标 采集结果为整数 smallint / int / bigint
采集指标 采集结果带小数,且小数点精确的位数固定,取值范围相对固定,如温度 decimal
采集指标 采集结果带小数,且小数点精确的位数不固定,取值范围大 float / double precision

注意!
除常用数据类型外,YMatrix 还支持可拓展数据类型 JSON、JSONB、MXKV空间数据类型