数据类型

TiDB Cloud Lake 将数据存储在强类型列中。本页概述支持的数据类型、自动/显式转换的工作方式，以及 NULL 或默认值的处理行为。

基础类型

数据类型	别名	存储 / 精度	最小值	最大值
BOOLEAN	BOOL	1 字节	–	–
BINARY	VARBINARY	可变	–	–
VARCHAR	STRING	可变	–	–
TINYINT	INT8	1 字节	-128	127
SMALLINT	INT16	2 字节	-32768	32767
INT	INT32	4 字节	-2147483648	2147483647
BIGINT	INT64	8 字节	-9223372036854775808	9223372036854775807
FLOAT	–	4 字节 (Float32)	-3.40e38	3.40e38
DOUBLE	–	8 字节 (Float64)	-1.79e308	1.79e308
DECIMAL	–	16/32 字节 (精度 ≤38/76)	`-(10^P-1)/10^S`	`(10^P-1)/10^S`

日期和时间类型

数据类型	别名	精度 / 说明
DATE	–	天级精度
TIMESTAMP	DATETIME	微秒，按会话时区输出
TIMESTAMP_TZ	–	微秒 + 存储偏移
INTERVAL	–	微秒，支持负时间跨度

结构化与半结构化类型

数据类型	示例	说明
ARRAY	`[1, 2, 3]`	具有相同内部类型的有序值列表。
TUPLE	`('2023-02-14','Valentine's Day')`	具有已声明元素类型的定长有序列表。
MAP	`{'a': 1, 'b': 2}`	键值集合（内部表示为键类型和值类型的元组）。
VARIANT	`[1, {"name":"datalake"}]`	类似 JSON 的容器，可混合原语、数组和对象。
BITMAP	`<bitmap binary>`	针对成员关系和集合运算优化的压缩位图。

领域特定类型

数据类型	说明
VECTOR	用于相似度搜索 / ML 工作负载的 Float32 向量嵌入。
GEOMETRY / GEOGRAPHY	以 WKB/EWKB 格式存储的空间对象。

类型转换与转换规则

显式类型转换

CAST(expr AS TYPE) 使用 ANSI 语法，在转换无效时会失败。
expr::TYPE 是 PostgreSQL 风格的简写。
TRY_CAST(expr AS TYPE) 在转换失败时返回 NULL，而不是抛出错误。

隐式类型转换（Coercion）

TiDB Cloud Lake 会在定义明确的场景下执行自动转换：

整数型会向上提升为 INT64。例如：UInt8 -> INT64。
数值类型在必要时会向上提升为 FLOAT64。
如果表达式中出现 NULL，任意类型 T 都可以变为 Nullable(T)。
所有类型都可以向上提升为 VARIANT。
复杂类型按元素进行强制转换（当 T -> U 时，Array<T> -> Array<U>；元组和映射同理）。

当目标列为 NOT NULL 时，如果数据中可能包含 NULL，请显式转换为 Nullable<T> 或使用 TRY_CAST。

SELECT CONCAT('1', col);      -- safe (strings)
SELECT CONCAT(1, col);        -- may fail if `col` can't coerce to number

NULL 处理与默认值

除非声明为 NOT NULL，否则列允许 NULL 值。当在 INSERT 时省略 NOT NULL 列，TiDB Cloud Lake 会写入该类型对应的默认值：

类型类别	默认值
整数型	`0`
浮点型	`0.0`
字符串 / 二进制	空字符串 / 空二进制
日期	`1970-01-01`
时间戳	`1970-01-01 00:00:00`
布尔型	`FALSE`

示例：

CREATE TABLE test (
    id   INT64,
    name STRING NOT NULL,
    age  INT32
);

INSERT INTO test (id, name, age) VALUES (2, 'Alice', NULL);  -- allowed
INSERT INTO test (id, name) VALUES (1, 'John');              -- age becomes NULL
INSERT INTO test (id, age) VALUES (3, 45);                   -- name uses default ''

你可以随时使用 DESC test 或 SHOW CREATE TABLE test 查看列的默认值和可空性。