SelectDB数据类型_云数据库 SelectDB 版(SelectDB)-阿里云帮助中心

为表字段选择合理的数据类型，不仅能够提升数据库的性能和存储效率，还能有助于维护数据库数据的完整性和可读性，并增强数据库的安全性和一致性。本文为您介绍云数据库 SelectDB 版所支持的数据类型。您也可以通过SHOW DATA TYPES;语句，快速查看SelectDB支持的所有数据类型。

数值类型

类型名称	字节数	描述
BOOLEAN	1	布尔值。 0：false 1：true
TINYINT	1	有符号整数。值范围：[-128, 127]
SMALLINT	2	有符号整数。值范围：[-32768, 32767]
INT	4	有符号整数。值范围：[-2147483648, 2147483647]
BIGINT	8	有符号整数。值范围：[-9223372036854775808, 9223372036854775807]
LARGEINT	16	有符号整数。值范围：[-2^127 + 1 ~ 2^127 - 1]
FLOAT	4	浮点数。值范围：[-3.410^38 ~ 3.410^38]
DOUBLE	8	浮点数。值范围：[-1.7910^308 ~ 1.7910^308]
DECIMAL	4/8/16	高精度定点数。定义格式：`DECIMAL(M[,D])` M：表示一共有多少个有效数字（precision）。值范围：[1, 38] D：代表小数位有多少数字（scale）。值范围：[0, precision] 0 <= precision <= 9时，占用4字节。 9 < precision <= 18时，占用8字节。 16 < precision <= 38时，占用16字节。

日期类型

类型名称

字节数

描述

DATE

日期类型。

取值范围：['0000-01-01', '9999-12-31']

默认输出格式：yyyy-MM-dd

DATETIME

日期时间类型。

定义格式：DATETIME([P])

说明

P：

表示时间精度。
默认值：0
取值范围：[0, 6]，即最多支持6位小数（微秒）。

取值范围：['0000-01-01 00:00:00[.000000]', '9999-12-31 23:59:59[.999999]']

默认输出格式：yyyy-MM-dd HH:mm:ss.SSSSSS

字符串类型

类型名称	字节数	描述
CHAR	M	定长字符串。定义格式：`CHAR(M)` 说明 M代表的是定长字符串的字节长度。占用空间大小：1~255个字节。
VARCHAR	不定长	变长字符串。定义格式：`VARCHAR(M)` 说明 M代表的是变长字符串的字节长度。变长字符串是以UTF-8编码存储的，因此通常英文字符占1个字节，中文字符占3个字节。占用空间大小：1~65533个字节。
STRING	不定长	变长字符串。默认占用的最小空间：1048576字节（1 MB）最大占用的空间大小：2147483643字节（2 GB）重要可通过参数`string_type_length_soft_limit_bytes`调整其空间大小。 STRING类型仅支持定义Value列，不能定义Key列和分区分桶列。

半结构类型

类型名称	字节数	描述
ARRAY	不定长	由T类型元素组成的数组。定义格式：ARRAY<T> 说明 T为基础数据类型。 T支持的类型： `BOOLEAN, TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL, DATE, DATEV2, DATETIME, DATETIMEV2, CHAR, VARCHAR, STRING` 使用注意事项：不支持定义Key列。仅支持在Duplicate和Unique模型的表中使用。
MAP	不定长	由K,V类型元素组成的Map。定义格式：MAP<K,V> 说明 K,V支持的类型： `BOOLEAN, TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL, DECIMALV3, DATE, DATEV2, DATETIME, DATETIMEV2, CHAR, VARCHAR, STRING` 使用注意事项：不支持定义Key列。仅支持在Duplicate和Unique模型的表中使用。
STRUCT	不定长	由多个Field组成的结构体，也可被理解为多个列的集合。定义格式：STRUCT<field_name:field_type, ... > 说明 field_name: Field的标识符，不可重复 field_type: Field的类型使用注意事项：不支持定义Key列。仅支持在Duplicate模型的表中使用。
JSON	不定长	采用二进制JSON格式存储，通过JSON函数访问JSON内部字段。默认支持的空间大小：1048576字节（1MB）最大支持的空间大小：2147483643字节（2GB）说明可通过参数`jsonb_type_length_soft_limit_bytes`调整其空间大小。
VARIANT	不定长	动态可变数据类型，专为半结构化数据如JSON设计，可以存入任意JSON，自动将JSON中的字段拆分成子列存储，提升存储效率和查询分析性能。VARIANT类型特别适用于处理复杂的嵌套结构，而这些结构可能随时会发生变化。使用注意事项： VARIANT类型仅支持定义Value列，不能定义Key列和分区分桶列。重要要求SelectDB内核版本`4.0.0`或以上，如不满足，请升级内核版本。

聚合类型

类型名称	字节数	描述
HLL	不定长	HLL是模糊去重，在数据量大的情况性能优于Count Distinct。使用注意事项：存在误差：通常在1%左右，有时会达到2%。建表时不能定义Key列，且聚合类型必须为HLL_UNION。不需要指定长度和默认值，其长度根据数据的聚合程度系统内控制。查询或使用必须通过`hll_union_agg`、`hll_raw_agg`、`hll_cardinality`、`hll_hash`函数才会生效。
BITMAP	不定长	用于精确去重，如 UV 统计，人群圈选等场景。使用注意事项： BITMAP类型可以定义Aggregate表、Unique 表或 Duplicate 表中的列，且必须为非Key列。在Aggregate表中使用时，还需配合聚合类型BITMAP_UNION使用。无需指定长度和默认值，其长度根据数据的聚合程度系统内控制。 BITMAP列只能通过配套的`bitmap_union_count`、`bitmap_union`、`bitmap_hash`、`bitmap_hash64`等函数进行查询或使用。
QUANTILE_STATE	不定长	用于计算分位数近似值的类型。在导入数据时会对相同的Key列，不同Value进行预聚合。 Value数量 <= 2048：采用明细记录所有数据。 Value数量 > 2048：采用TDigest算法，对数据进行聚合（聚类）保存聚类后的质心点。使用注意事项：建表时不能定义key列，且表的聚合类型必须为QUANTILE_UNION。无需指定长度和默认值，其长度根据数据的聚合程度系统内控制。仅支持通过配套的`QUANTILE_PERCENT`、`QUANTILE_UNION`、`TO_QUANTILE_STATE`等函数进行查询或使用。
AGG_STATE	不定长	聚合函数。用于聚合计算加速，且只能配合`state/merge/union`函数组合器使用。使用注意事项： AGG_STATE不能作为Key列使用，建表时需要同时声明聚合函数的签名。无需指定长度和默认值，其实际存储的数据大小与函数实现有关。

IP类型

重要

以下数据类型，仅SelectDB内核版本4.0.0或以上支持，如不满足，请升级实例内核版本，如何升级，请参见升级内核版本。

类型名称	字节数	描述
IPv4	4字节	以4字节二进制存储IPv4地址，配合ipv4_*系列函数使用。
IPv6	16字节	以16字节二进制存储IPv6地址，配合ipv6_*系列函数使用。