PostgreSQL 数据类型
PostgreSQL-compatible TiDB Cloud Starter 支持常见的 PostgreSQL 数据类型,适用于数值、文本、二进制、日期和时间、JSON、数组、向量以及全文搜索工作负载。
支持的数据类型
支持以下数据类型:
以下 PostgreSQL 数据类型可以接受,但存在兼容性差异:
SMALLINT和INT2:内部按INTEGER存储。不强制执行 PostgreSQLSMALLINT的取值范围。REAL和FLOAT4:内部按DOUBLE PRECISION存储,不具备 PostgreSQL 单精度浮点语义。CHAR(n)和CHARACTER(n):内部按VARCHAR存储,不具备 PostgreSQL 定长空格填充语义。
数值类型
对整数值使用 INTEGER 或 BIGINT:
CREATE TABLE counters (
id BIGSERIAL PRIMARY KEY,
count INTEGER NOT NULL,
total BIGINT
);
在需要精确十进制值时,使用 NUMERIC:
CREATE TABLE products (
id BIGSERIAL PRIMARY KEY,
price NUMERIC(10, 2)
);
PostgreSQL-compatible TiDB Cloud Starter 使用 96 位系数存储 NUMERIC 值,可容纳大约 28–29 位有效十进制数字。通过调整小数点位置,最多可支持 28 位小数。
即使声明了更大的精度或小数位数,仍然适用以下限制:
NUMERIC(38,0)不支持存储 38 位整数。支持的最大整数为79228162514264337593543950335;更大的整数无法存储。- 声明的小数位数大于 28 时,也无法保留超过 28 位小数。例如,将
0.12345678901234567890123456789012345存储到NUMERIC(60,35)列中时,会被舍入为0.1234567890123456789012345679。
在从 PostgreSQL 迁移数据之前,请验证你的数值是否在支持的范围内。
对浮点值使用 DOUBLE PRECISION:
CREATE TABLE measurements (
id BIGSERIAL PRIMARY KEY,
value DOUBLE PRECISION
);
字符和二进制类型
对可变长度文本使用 TEXT:
CREATE TABLE documents (
id BIGSERIAL PRIMARY KEY,
title TEXT,
body TEXT
);
当你希望限制最大字符长度时,使用 VARCHAR(n):
CREATE TABLE users (
id BIGSERIAL PRIMARY KEY,
username VARCHAR(64) NOT NULL
);
使用 BYTEA 存储二进制数据:
CREATE TABLE files (
id BIGSERIAL PRIMARY KEY,
content BYTEA
);
日期和时间类型
PostgreSQL-compatible TiDB Cloud Starter 支持 DATE、TIME、TIMESTAMP、TIMESTAMPTZ 和 INTERVAL。
例如:
CREATE TABLE events (
id BIGSERIAL PRIMARY KEY,
event_date DATE,
start_time TIME,
created_at TIMESTAMP,
published_at TIMESTAMPTZ,
duration INTERVAL
);
在需要时,使用 PostgreSQL 类型化字面量:
SELECT
DATE '2026-09-19',
TIME '15:30:00',
TIMESTAMP '2026-09-19 15:30:00',
TIMESTAMPTZ '2026-09-19 15:30:00+00',
INTERVAL '2 hours';
时间戳精度
时间戳以微秒精度存储。
类型语法中接受 0 到 6 的精度参数,但它们不会截断已存储的小数秒。
例如,TIMESTAMP(3) 仍然可以保留 6 位小数。
Interval 运算
INTERVAL 会分别保留基于月份和不足一个月的组成部分,从而支持具备日历感知能力的日期运算。
你可以对 INTERVAL 进行加、减、乘、除运算:
SELECT
INTERVAL '1 day' * 2 AS two_days,
2 * INTERVAL '1 day' AS two_days_again,
INTERVAL '1 day' / 2 AS half_day,
INTERVAL '1 day' + INTERVAL '1 hour' AS day_and_hour,
INTERVAL '3 days' - INTERVAL '1 day' AS two_days,
INTERVAL '0 day' - INTERVAL '1 day' AS negative_day,
NOW() - 7 * INTERVAL '1 day' AS one_week_ago;
UUID
使用 UUID 存储 128 位 UUID 值:
CREATE TABLE sessions (
id UUID PRIMARY KEY,
user_id BIGINT NOT NULL
);
INET
使用 INET 存储 IPv4 或 IPv6 主机或网络地址:
CREATE TABLE access_log (
id BIGSERIAL PRIMARY KEY,
client_ip INET
);
例如:
INSERT INTO access_log (client_ip)
VALUES
('192.168.1.10'),
('10.0.0.0/8'),
('::1');
支持相等比较和排序比较。某些 PostgreSQL 网络运算符和函数暂不支持。参见PostgreSQL 兼容性。
JSON and JSONB
当保留原始 JSON 文本表示很重要时,请使用 JSON。当需要规范化表示以及 JSON 包含等操作时,请使用 JSONB。
例如:
CREATE TABLE profiles (
id BIGSERIAL PRIMARY KEY,
settings JSONB
);
INSERT INTO profiles (settings)
VALUES ('{"theme":"dark","notifications":true}');
SELECT *
FROM profiles
WHERE settings @> '{"theme":"dark"}';
Arrays
使用 type[] 定义数组:
CREATE TABLE articles (
id BIGSERIAL PRIMARY KEY,
tags TEXT[]
);
插入并访问数组值:
INSERT INTO articles (tags)
VALUES (ARRAY['database', 'cloud', 'postgresql']);
SELECT tags[1]
FROM articles;
Vector and full-text search types
VECTOR(n) 可用于向量搜索:
CREATE TABLE embeddings (
id BIGSERIAL PRIMARY KEY,
embedding VECTOR(3)
);
有关向量运算符和 HNSW 索引的信息,参见向量搜索。
TSVECTOR 和 TSQUERY 可用于兼容 PostgreSQL 的全文搜索:
SELECT
to_tsvector('simple', 'PostgreSQL full text search')
@@ plainto_tsquery('simple', 'PostgreSQL');
更多信息,参见全文搜索。
Type coercion
兼容 PostgreSQL 的 TiDB Cloud Starter 在常见 SQL 上下文中支持 PostgreSQL 风格的类型强制转换。
UNION, CASE, COALESCE, and VALUES
当文本与另一种已确定类型的值组合时,该表达式可以解析为文本类型。
例如:
SELECT 1
UNION
SELECT 'a';
Comparisons
当文本字面量与已确定类型的值进行比较时,如果可能,文本字面量会被强制转换为另一个操作数的类型。
例如:
CREATE TABLE example (
id INTEGER PRIMARY KEY
);
SELECT *
FROM example
WHERE id = '42';
在此示例中,'42' 会被强制转换为 INTEGER。
Numeric type promotion
当数值类型组合使用时,结果会按照以下一般优先级进行提升:
INTEGER -> BIGINT -> DOUBLE PRECISION -> NUMERIC
与 PostgreSQL 不同,组合 DOUBLE PRECISION 和 NUMERIC 会产生 NUMERIC 结果。例如:
SELECT pg_typeof(1::double precision + 2::numeric);
此查询返回 numeric。
如果你的应用需要 DOUBLE PRECISION 结果,请将 NUMERIC 操作数显式转换为 DOUBLE PRECISION。
Temporal type promotion
常见时间类型表达式的提升规则如下:
Type casts
可以使用任一 PostgreSQL 类型转换语法:
SELECT CAST('42' AS INTEGER);
SELECT '42'::INTEGER;
显式类型转换比赋值转换和隐式类型转换更宽松。例如,显式类型转换可以执行某些 INSERT 或 UPDATE 赋值会拒绝的转换。