PostgreSQL / 系统课时
插入单行数据
插入单行数据
本课解决如何向 PostgreSQL 表中新增一条完整记录。完成后,你能使用 INSERT INTO 明确指定目标列和值,通过查询验证插入结果,并判断省略列时数据库会采用默认值、写入 NULL 还是报错。
学习目标
- 掌握单行
INSERT的基本语法 - 理解列清单与值清单的对应关系
- 知道何时可以省略未赋值的列
使用 INSERT 指定列和值
推荐始终写出列名,语法更清晰,也不会依赖表中字段的物理顺序。INSERT INTO 表名 (列名列表) VALUES (值列表) 是最常用的单行插入形式。列和值必须一一对应,数量和数据类型都要匹配。
下面创建一张用户表,插入用户 alice,再查询数据库实际保存的记录。示例使用 PostgreSQL 原生 SQL,可在连接到练习数据库后的 psql 或 SQL 编辑器中执行。
-- 清理同名练习表,保证重复执行时结果一致
DROP TABLE IF EXISTS lesson_user;
CREATE TABLE lesson_user (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
username varchar(50) NOT NULL,
email varchar(100),
status varchar(20) NOT NULL DEFAULT 'active'
);
-- 只给业务列赋值,id 和 status 由数据库处理
INSERT INTO lesson_user (username, email)
VALUES ('alice', 'alice@example.com');
SELECT id, username, email, status
FROM lesson_user;预期结果:INSERT 成功执行后,查询得到一条记录。在新建的练习表中,首次生成的 id 为 1。
id | username | email | status
----+----------+-------------------+--------
1 | alice | alice@example.com | active
(1 row)执行过程中,PostgreSQL 还会显示 INSERT 0 1,其中最后的 1 表示成功插入一行。如果最后的查询没有返回 alice,应先确认是否在同一个数据库和模式中执行了建表、插入与查询语句。
省略列时发生什么
示例中没有写 id 和 status:id 使用标识列自动生成,status 使用默认值 active。如果省略的列既没有默认值,又声明为 NOT NULL,插入会失败。
对于允许为空且没有默认值的列,例如 email,省略时会写入 NULL。但 username 被声明为 NOT NULL,又没有默认值,因此不能直接省略。
虽然 PostgreSQL 允许省略列清单并按表中列顺序赋值,但这种写法容易因表结构调整而出错,不适合业务 SQL。对于本例的 GENERATED ALWAYS AS IDENTITY 列,通常应让数据库生成 id,而不是尝试手动赋值。
区分默认值与 NULL
省略列、使用 DEFAULT 和显式写入 NULL 并不完全相同。 当列有默认值时,省略该列或在对应位置使用 SQL 关键字 DEFAULT,都会采用定义好的默认值;显式写入 NULL 则不会自动转换为默认值。
以 status 为例,省略后得到 active;如果显式传入 NULL,会因为 NOT NULL 约束而插入失败。对于允许为空的 email,显式传入 NULL 则合法。
还有两项边界需要留意:字符串中的单引号必须正确转义,实际应用中应使用参数化 SQL 传值;即使列值数量正确,超出 varchar(50) 长度或违反唯一性、外键等约束时,插入仍可能失败。
写入前检查
插入前重点确认三点:目标列是否存在、值的顺序是否对应、必填列是否已提供。字符串使用单引号,数值通常不加引号。
完成插入后,可以像主示例一样使用 SELECT 查询实际保存的数据。检查 username 是否为 alice、email 是否正确、status 是否为 active,并确认只返回一条记录。
如果业务需要立即获得新记录的主键,还可以在 INSERT 语句末尾追加 RETURNING id,让 PostgreSQL 直接返回新生成的 id,不必再根据用户名查询。单行插入的可靠做法是明确列清单、正确处理默认值,并通过返回值或查询结果确认写入成功。