PostgreSQL 创建表格（快速上手）

PostgreSQL 创建表格：从零开始构建数据结构

你有没有想过，一个网站背后的数据是怎么“安家落户”的？用户注册信息、商品列表、订单记录……这些数据并不是凭空出现的，而是通过一个个精心设计的表格来组织和存储的。在众多数据库系统中，PostgreSQL 以其强大的功能和稳定性，成为许多开发者的首选。而这一切的起点，就是学会如何使用 PostgreSQL 创建表格。

如果你是初学者，可能对“表”这个概念还有点模糊。不妨把它想象成一张 Excel 表格：每一行代表一条记录，每一列定义了数据的类型和含义。在 PostgreSQL 中，这张“表格”就是通过 SQL 语句来定义的，而“创建表格”正是我们与数据库对话的第一步。

掌握 PostgreSQL 创建表格，就像是在搭建一座数据大厦的地基。地基越牢固，上面的房子就越稳定。接下来，我们一步步拆解这个过程，让你不仅会写，还能理解背后的原理。

基本语法与结构解析

在 PostgreSQL 中，创建表格的核心语句是 CREATE TABLE。它的基本语法如下：

CREATE TABLE 表名 (
    列名 数据类型 约束条件,
    列名 数据类型 约束条件,
    ...
);

我们来分解一下这个结构：

• CREATE TABLE：这是创建表的命令，告诉数据库“我要新建一个表”。
• 表名：你给这张表起的名字，比如 users、products，要符合命名规范，不能用保留字。
• 列名：每一列的名称，代表数据的一个属性，比如 id、name、email。
• 数据类型：定义这一列能存什么类型的数据，比如整数、字符串、日期等。
• 约束条件：对数据的额外限制，比如不能为空、必须唯一等。

举个例子，我们创建一个简单的用户表：

CREATE TABLE users (
    id SERIAL PRIMARY KEY,                    -- 自增主键，唯一标识每个用户
    username VARCHAR(50) NOT NULL,            -- 用户名，最多 50 个字符，不能为空
    email VARCHAR(100) UNIQUE NOT NULL,       -- 邮箱，唯一且不能为空
    created_at TIMESTAMP DEFAULT NOW()        -- 创建时间，默认为当前时间
);

注释说明：

• SERIAL 是 PostgreSQL 中自动递增整数的简写，等价于 INTEGER 且带有 AUTO_INCREMENT 功能。
• PRIMARY KEY 表示这一列是主键，必须唯一且非空。
• NOT NULL 要求该字段必须有值，不能留空。
• UNIQUE 确保该字段的值在整个表中唯一。
• DEFAULT NOW() 表示如果没有显式插入时间，系统会自动使用当前时间。

常用数据类型详解

在创建表格时，选择合适的数据类型至关重要。错误的类型可能导致存储浪费、查询性能下降，甚至数据错误。以下是 PostgreSQL 中最常用的几种数据类型：

数值类型

-- 示例：创建商品表，价格使用 NUMERIC 类型保证精度
CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price NUMERIC(10, 2) NOT NULL DEFAULT 0.00  -- 最多 10 位，2 位小数
);

字符串类型

-- 示例：使用 TEXT 存储长文本内容
CREATE TABLE articles (
    id SERIAL PRIMARY KEY,
    title VARCHAR(200) NOT NULL,
    content TEXT NOT NULL,          -- 内容可能很长，用 TEXT 更合适
    author VARCHAR(50) NOT NULL
);

日期与时间类型

-- 示例：记录用户登录日志
CREATE TABLE login_logs (
    id SERIAL PRIMARY KEY,
    user_id INTEGER NOT NULL,
    login_time TIMESTAMPTZ DEFAULT NOW(),  -- 自动记录登录时间
    ip_address INET NOT NULL              -- 存储 IP 地址
);

注意：INET 类型用于存储 IPv4 或 IPv6 地址，是 PostgreSQL 的扩展类型，非常实用。

约束条件：为数据加锁

约束是 PostgreSQL 创建表格时最强大的工具之一。它不是可有可无的功能，而是确保数据质量的“守门员”。

主键（PRIMARY KEY）

主键是表中每一行的唯一标识。一个表只能有一个主键，但可以是多个列的组合（复合主键）。

-- 创建订单明细表，订单号 + 商品ID 作为复合主键
CREATE TABLE order_items (
    order_id INTEGER NOT NULL,
    product_id INTEGER NOT NULL,
    quantity INTEGER NOT NULL,
    price NUMERIC(10, 2) NOT NULL,
    PRIMARY KEY (order_id, product_id)  -- 复合主键
);

唯一约束（UNIQUE）

确保某列或某几列的值在整个表中不重复。

-- 用户表中邮箱必须唯一
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL  -- 邮箱不能重复
);

检查约束（CHECK）

用于限制列中允许的值范围。

-- 限制年龄在 1 到 120 之间
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    age INTEGER CHECK (age >= 1 AND age <= 120)
);

外键约束（FOREIGN KEY）

这是连接多张表的关键。它确保一个表中的值必须在另一个表中存在。

-- 用户表
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL
);

-- 订单表，user_id 引用 users 表的 id
CREATE TABLE orders (
    id SERIAL PRIMARY KEY,
    user_id INTEGER NOT NULL,
    amount NUMERIC(10, 2) NOT NULL,
    FOREIGN KEY (user_id) REFERENCES users(id)  -- 外键约束
);

如果尝试插入一个 user_id 在 users 表中不存在的订单，PostgreSQL 会抛出错误，防止“孤儿记录”。

实际案例：电商系统中的表结构设计

让我们用一个真实的场景来巩固所学知识。假设你要开发一个小型电商系统，需要设计以下几张表：

1. 用户表（users）

CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    password_hash TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

2. 商品表（products）

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    description TEXT,
    price NUMERIC(10, 2) NOT NULL CHECK (price >= 0),
    stock INTEGER NOT NULL DEFAULT 0 CHECK (stock >= 0),
    category VARCHAR(50) NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

3. 订单表（orders）

CREATE TABLE orders (
    id SERIAL PRIMARY KEY,
    user_id INTEGER NOT NULL REFERENCES users(id),
    total_amount NUMERIC(12, 2) NOT NULL CHECK (total_amount >= 0),
    status VARCHAR(20) DEFAULT 'pending' CHECK (status IN ('pending', 'paid', 'shipped', 'completed')),
    created_at TIMESTAMP DEFAULT NOW()
);

4. 订单明细表（order_items）

CREATE TABLE order_items (
    id SERIAL PRIMARY KEY,
    order_id INTEGER NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
    product_id INTEGER NOT NULL REFERENCES products(id),
    quantity INTEGER NOT NULL CHECK (quantity > 0),
    price_at_time NUMERIC(10, 2) NOT NULL,  -- 记录下单时的价格
    UNIQUE (order_id, product_id)           -- 防止重复添加同一商品
);

注释说明：

• ON DELETE CASCADE 表示当订单被删除时，其明细也会自动删除，保持数据一致性。
• CHECK (status IN (...)) 限制状态字段只能是预定义的几个值。

常见错误与调试技巧

在实际操作中，新手常遇到以下问题：

错误 1：列名或表名使用了保留字

比如使用 order 作为表名，会报错，因为 order 是 SQL 保留字。

✅ 正确做法：用反引号包裹或改名，如 orders。

错误 2：数据类型不匹配

比如把字符串插入 INTEGER 列，会提示类型不匹配。

✅ 解决方法：检查数据类型是否一致，必要时使用 CAST 转换。

错误 3：外键引用不存在的表

如果先创建 order_items 表，再创建 users 表，就会出错。

✅ 原则：先创建被引用的表，再创建引用表。

调试建议

• 使用 psql 命令行工具执行 SQL。
• 用 \d 查看当前数据库中所有表。
• 用 \d 表名 查看某张表的结构。

总结：从创建表格开始，构建可靠的数据系统

PostgreSQL 创建表格，远不止是写几行 SQL 代码那么简单。它是一次对数据逻辑的思考，是对未来数据一致性、可维护性的投资。从主键、外键到约束，每一个细节都在为系统的稳定运行保驾护航。

无论是初学者还是中级开发者，掌握 PostgreSQL 创建表格，都是迈向专业开发的第一步。当你能独立设计出一张结构合理、约束完善的表时，你就真正理解了数据的本质。

记住，数据库不是“存数据的盒子”，而是一个“管理数据的系统”。而你，就是这个系统的建筑师。从今天开始，用 SQL 一笔一划，搭建属于你的数据世界。