Menu

PostgreSQL CREATE TABLE 建表语法与示例

CREATE TABLE 定义表的列、类型和约束。内容包括标识列主键、NOT NULL、DEFAULT、UNIQUE、CHECK、IF NOT EXISTS、CREATE TABLE AS 和 LIKE。

本页包含可运行的编辑器。编辑、运行,立即查看输出。

CREATE TABLE name (column type constraints, ...) 用来创建表。每一列都有名字和数据类型,后面可以加上约束,比如 PRIMARY KEY、NOT NULL、DEFAULT、UNIQUE 或 CHECK。

id 列会自动编号;插入时没有给 plan,它就使用 'free';created_at 记录插入的时间。常用的列类型见数据类型页面。

列约束

约束作用
PRIMARY KEY唯一且非空;每张表只能有一个
NOT NULL这一列必须有值
DEFAULT expr插入时省略这一列所使用的值
UNIQUE任意两行的值都不能相同(允许多个 NULL)
CHECK (expr)拒绝让表达式为假的行
REFERENCES t (col)指向另一张表的外键

从 PostgreSQL 15 开始,UNIQUE NULLS NOT DISTINCT 会把 NULL 视为相等,这样这一列中只能有一行是 NULL。

跨多列的规则

涉及多列的约束放在列定义之后,单独占一行。用 CONSTRAINT name 给它命名,错误信息会更容易看懂,以后也能按名字删除它。

这个查询列出了三个约束。没有命名的约束得到了自动生成的名字:bookings_guests_check 和 bookings_pkey。

表不存在时才创建

IF NOT EXISTS 让第二条 CREATE TABLE 只产生一条提示,而不是报错。它只检查名字。如果已经有一张叫 logs 的表,即使列不同,也不会有任何变化。

根据查询或另一张表创建表

CREATE TABLE ... AS 用 SELECT 的结果创建表,列和类型都来自结果。LIKE 复制另一张表的定义但不复制行,加上 INCLUDING ALL 会把默认值、约束、标识列和索引一起带过来。

big_orders 有一行。orders_archive 有 orders 的列和约束,但没有行。

生成列

生成列由同一行的其他列计算得出,插入时不能给它写值。在 PostgreSQL 17 中,它必须是 STORED:值在写入时计算并保存到磁盘上。

总额分别是 13.5 和 20。

临时表和不记日志的表

CREATE TEMP TABLE 创建的表只有当前会话能看到,会话结束时就会被删除。它适合存放长脚本中的中间结果。CREATE UNLOGGED TABLE 跳过预写日志(WAL),所以写入更快。这种表在崩溃后会被清空,也不会复制到副本上,所以只用来存放可以重新生成的数据。

CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);

表创建之后要修改,用 ALTER TABLE。所有选项都列在 CREATE TABLE 参考文档中。

常见问题

PostgreSQL 的表名区分大小写吗?

不加引号的名字会被转成小写,所以 CREATE TABLE Users 创建的是 users。加了引号的名字(比如 "Users")会保留大小写,之后每次查询都必须加引号,所以大家通常用小写的 snake_case 命名。

PostgreSQL 中怎么查看表结构?

在 psql 中,\d table_name 会显示列、类型、默认值、索引和约束。用 SQL 的话,查询 information_schema.columns WHERE table_name = 'table_name'。

PostgreSQL 中怎么复制一张表?

CREATE TABLE copy AS TABLE original; 复制列和行,但不复制约束和索引。CREATE TABLE copy (LIKE original INCLUDING ALL); 复制表结构以及默认值、约束和索引,但不复制行。

PostgreSQL 中怎么删除表?

DROP TABLE table_name; 删除表及其数据。DROP TABLE IF EXISTS table_name; 在表不存在时跳过报错,CASCADE 还会删除依赖这张表的视图和外键。

Coddy 编程语言插图

和 Coddy 一起学编程

开始