PostgreSQL 数据类型

这一课你将能做到

1. 为练习表选用 UUID、JSONB、TEXT[]、TIMESTAMPTZ 四类高频类型并完成增删改查
2. 说明为何业务库优先 JSONB 而非 JSON，以及数组适合什么、不适合什么
3. 对照本站 MySQL 的整型主键 / DATETIME 习惯，写出「何时仍用 BIGINT 主键」的判断

为什么要学

关系型不只是 INT + VARCHAR。PostgreSQL 内置类型丰富：UUID 适合对外暴露的标识，JSONB 存半结构化配置，数组存简单多值，timestamptz 正确处理时区。不会选类型，后面索引与 API 映射都会别扭。

本课聚焦四类日常高频；JSONB 的运算符与 GIN 索引在下一课展开。官方类型一览见 PostgreSQL 文档 Data Types 章。

先建立图像

一行 cf_track 可以长这样（概念上）：

 id          BIGINT / UUID     ← 谁唯一认出这一行
 slug        VARCHAR           ← 给人看的稳定键
 metadata    JSONB             ← 扩展袋：标签、开关、统计
 tags        TEXT[]            ← 简单多值（也可用 JSONB 数组）
 created_at  TIMESTAMPTZ       ← 「绝对时间」+ 展示时换区

类型	人话	典型用途
UUID	全球唯一的 128 位标识	API key、分布式 ID
JSONB	可索引的二进制 JSON	扩展字段、配置、嵌套文档
JSON	保留文本形态的 JSON	几乎总改选 JSONB
TEXT[]	文本数组	标签、简单枚举多选
TIMESTAMPTZ	带时区的时间戳	创建/更新时间
TIMESTAMP	无时区	易踩坑，业务库少用

跟着做

步骤 1：准备扩展与 schema

docker exec -it pg-dev psql -U codeforge -d codeforge_pg

CREATE SCHEMA IF NOT EXISTS app;

-- gen_random_uuid() 在较新版本可用；pgcrypto 提供加密相关函数
CREATE EXTENSION IF NOT EXISTS pgcrypto;

若 gen_random_uuid() 已存在于核心，扩展仍常装，便于文档与旧库一致。

步骤 2：UUID 主键表示例

CREATE TABLE IF NOT EXISTS app.api_key (
    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 插入时自动生成
    name       TEXT NOT NULL,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

INSERT INTO app.api_key (name) VALUES ('local-dev');
SELECT id, name, created_at FROM app.api_key;

应看到一串 UUID。注意：本站 仍是 ——OLTP 自增主键很常见；UUID 适合「不可猜测、跨系统合并」场景，不要教条「全部改 UUID」。