【免费下载链接】til
:memo: Today I Learned
在 PostgreSQL 日常开发中,常常需要以一张现有表为模板快速创建一张结构相同(或结构近似)的新表——例如为测试搭建一张影子表、为临时计算建立同构中间表、或为归档拆分出一张字段一致的副本。本文基于本仓库 postgres/create-a-table-from-the-structure-of-another.md 的核心内容,系统讲解两种主流实现方式:CREATE TABLE AS 与 CREATE TABLE (LIKE ...),并深入展开 INCLUDING 系列选项的复制范围、底层行为与实战陷阱,读完即可在 psql 中直接落地使用。
一、两种方式快速对比
| 维度 | CREATE TABLE AS ... WITH NO DATA | CREATE TABLE (LIKE ...) |
|---|---|---|
| 基本语法 | create table dupe as table src with no data; | create table dupe (like src); |
| 默认复制范围 | 列名 + 数据类型 | 列名 + 数据类型(not null 约束总是被复制) |
| 修饰符 / 默认值 | 不复制 | 需 including defaults |
| 索引 | 不复制 | 需 including indexes |
| 约束 | 不复制 | 需 including constraints |
| 灵活性 | 低,几乎无选项 | 高,支持细粒度 including 组合 |
| 典型用途 | 快速克隆列结构做临时表 | 精确复制表结构(含索引、约束等) |
从上表可以直观看到:两种写法在"默认只复制列与数据类型"这一点上行为一致,但 LIKE 语法通过可选的 INCLUDING 子句提供了远超 CREATE TABLE AS 的控制力,这也是后者更受推荐的根本原因。
二、方式一:CREATE TABLE AS ... WITH NO DATA
CREATE TABLE AS(CTAS)是 PostgreSQL 中"用查询结果建表"的经典语法。本仓库文档给出的最小示例是:
create table dupe_table as table existing_table with no data;
这里 table existing_table 是 select * from existing_table 的简写形式;with no data 则明确告诉 PostgreSQL:只建表、不灌入任何数据。去掉 with no data 的话,新表会同时把源表的全部行复制过去,相当于"复制表 + 复制数据"一箭双雕。
不过,正如 postgres/create-a-table-from-the-structure-of-another.md 中所提醒的,这种方式并不推荐用于"精确克隆结构",原因在于它只还原了列名与数据类型,而列的修饰符(modifiers)、索引和约束全部丢失:
not null、check等列级约束不会带过来;- 主键、唯一约束、外键不会带过来;
- 表上的索引(包括 B-Tree、GIN 等)不会带过来;
- 列的默认值(
default表达式)不会带过来。
因此 CTAS 更适合的场景是"我要一张和某表列结构一致、用来装临时数据的空壳",而不是"我要一张结构完全相同的副本表"。如果目标是后者,请使用 LIKE 语法。
三、方式二:CREATE TABLE (LIKE ...) 基础用法
CREATE TABLE 语法中的 LIKE 子句是专门为"复制另一张表的定义"而设计的:
create table dupe_table (like existing_table);
这条语句的行为与上一节的 CTAS 写法一致——同样只复制列名和数据类型,不会自动带上默认值、索引或约束(not null 例外,见下文第四节)。但它真正的价值在于:可以在括号内追加一个或多个 INCLUDING 选项,精确声明要把源表的哪些"附加定义"一并复制过来。这让 LIKE 从"简陋的列克隆"升级为"可控的表结构复制器"。
四、INCLUDING 选项详解:精确控制复制范围
本仓库原文档给出了一个非常实用的组合示例,同时复制默认值、索引和约束:
create table dupe_table (
like existing_table
including defaults
including indexes
including constraints
)
这条语句的效果是:dupe_table 不仅拥有与 existing_table 相同的列和数据类型,还一并还原了列的默认值、B-Tree 等索引以及表级约束。
PostgreSQL 为 LIKE 子句提供的 INCLUDING 选项远不止这三个,完整的可用选项如下:
| 选项 | 复制的内容 |
|---|---|
including defaults | 列的 default 默认值表达式 |
including constraints | check 约束(not null 始终复制,见下) |
including indexes | 源表的索引;主键与唯一约束的支撑索引也会随之重建 |
including identity | identity 列的定义(复制表会获得全新的独立序列) |
including generated | 生成列(generated column)的生成表达式 |
including storage | 列的存储参数(如 plain、external、extended、main) |
including comments | 表、列、索引等对象上的注释 |
including statistics | 列的统计目标(ALTER TABLE ... SET STATISTICS 设置的值) |
including compression | 列的压缩方法 |
including all | 上述除 indexes 外全部选项的组合缩写 |
使用时有几个容易踩坑的细节值得展开:
1. not null 约束不需要 including constraints。 PostgreSQL 中 LIKE 复制时,not null 约束总是会被带到新表,无论你是否写 including constraints。也就是说,including constraints 真正补充复制的主要是 check 约束。原文档示例中"用 including constraints 复现 not null"的说法,从最终结果看没有问题,但严格讲 not null 的复制是 LIKE 的默认行为。
2. 主键 / 唯一约束依赖 including indexes 才能"复活"。 including constraints 并不会复制 primary key、unique、foreign key 这三类约束本身;主键与唯一约束之所以能在复制表中继续生效,是因为 including indexes 会把它们背后的支撑索引(主键索引、唯一索引)一并重建到新表上。而外键约束无论如何都不会被复制,复制表与其它表之间的引用关系需要你手动重新 add constraint。
3. including all 其实不包含索引。 这是最容易产生误解的一点:including all 是除 indexes 之外其余选项(defaults、constraints、identity、generated、storage、comments、statistics、compression)的组合缩写。如果你希望"复制一切",请写成 including all including indexes 这样的组合,而不是单独依赖 including all。
4. 复制默认值时留意序列的归属。 如果源表的主键列使用 serial/bigserial,其默认值实际是 nextval('existing_table_id_seq') 这样的表达式。including defaults 会把这一默认表达式原样复制,但序列对象本身并不会被复制——结果就是复制表与原表共享同一个序列。关于这一点,结合仓库内 postgres/generate-modern-primary-key-columns.md 的讨论可以看得更清楚:serial 本就是一种"语法糖",PostgreSQL 社区更推荐新项目使用 identity 列。若源表使用 generated always as identity,则 including identity 会为复制表创建一套全新的、独立的序列,避免共享序列带来的插入冲突。
五、实战演示:从零复现一个"带约束和索引"的表
下面用一个完整、可运行的示例串联以上知识点。先在 psql 中创建一个相对复杂的源表:
create table existing_table (
id integer generated always as identity primary key,
title text not null,
status varchar(10) not null default 'active',
check (status in ('active', 'archived', 'deleted'))
);
create index existing_table_status_idx
on existing_table (status);
该表包含:identity 主键列、not null 约束、带默认值的列、check 约束,以及一个 B-Tree 索引——几乎覆盖了复制场景的全部要素。
场景一:只要列结构的空壳。 复制表不含默认值、索引与约束:
create table dupe_min (like existing_table);
场景二:原文档推荐的完整复制。 列、默认值、索引、约束一并还原:
create table dupe_full (
like existing_table
including defaults
including indexes
including constraints
);
场景三:字面意义的"复制一切"。 注意索引仍需显式指定:
create table dupe_everything (
like existing_table
including all
including indexes
);
创建完成后,用 psql 的 \d 命令验证复制效果:
\d dupe_full
在输出中你可以看到:id 列带有 generated always as identity 且是主键、title/status 带 not null、status 保留 default 'active' 与 check 约束,索引列表里也出现了 existing_table_status_idx。反过来对 dupe_min 执行同样的命令,则只看到裸的列定义。
复制索引时的命名注意
通过 including indexes 复制过来的索引会沿用源索引的名称。如果目标表所在的 schema 中已经存在同名索引,创建会直接失败并报错。此时可以先让复制语句只处理列与约束,再手动用 create index ... on dupe_table (...) 重建并另起名称,或参考仓库内 postgres/create-an-index-across-two-columns.md 的思路规划索引列组合。
复制表也是"一张全新的表"
值得补充的一点:每执行一次 create table,PostgreSQL 都会在 pg_type 中登记一个与该表同名的复合类型(对应表中一行的类型),正如仓库内 postgres/create-table-adds-a-data-type.md 所记录的。因此复制出来的 dupe_full 也是一个独立的数据类型,与原表互不干扰,你完全可以对两张表做独立的结构演进。
六、与其他"复制结构"方案对比:pg_dump --schema-only
除了在会话内用 SQL 复制结构,仓库内还有另一条"离线式"路线——见 postgres/dump-the-sql-needed-recreate-a-table.md:用 pg_dump 导出重建某张表所需的完整 DDL:
pg_dump -t 'existing_table' --schema-only my_database > existing_table.schema.sql
-t 指定目标表,--schema-only 表示只导出结构、不导出数据。生成的 .sql 文件包含建表语句、序列定义、外键约束与索引等一整套 DDL,之后可以用 psql -f 手动执行或交给恢复工具重建。
两种思路的取舍如下:
CREATE TABLE (LIKE ...):在数据库会话内即时完成,无需文件与权限切换,适合"当场克隆一张表"的动态场景;pg_dump --schema-only:输出可审计、可版本化的 DDL 脚本,适合"把表结构归档到迁移脚本/代码仓库"的静态场景。
七、注意事项与最佳实践小结
- 明确复制目标:只要列结构,用
create table as ... with no data即可;要完整结构,优先create table (like ...)并组合including选项。 - 主键与唯一约束靠索引复制:想保留这两类约束,必须带
including indexes;including constraints只管check(not null则始终复制)。 including all不包含索引:需要"一切"时写including all including indexes。- 序列归属要心里有数:
serial源表的默认值复制后与原表共享序列;identity 源表配合including identity可获得独立序列。新表设计建议参考 postgres/generate-modern-primary-key-columns.md 改用 identity 列。 - 外键不会被复制:复制表与其他表的引用关系需重建,可参考 postgres/references-target-primary-key-by-default.md 了解外键默认引用主键的写法。
- 留意索引重名:复制索引沿用原名,同名会报错,必要时手动重建并改名。
- schema 归属:
create table会落在search_path解析出的默认 schema 下,跨 schema 复制时可用schema.dupe_table显式指定目标位置,相关机制见 postgres/default-schema.md。
八、结语
从"只复制列和数据类型"的 CREATE TABLE AS,到支持 including defaults/indexes/constraints/identity/all 等细粒度选项的 CREATE TABLE (LIKE ...),PostgreSQL 为"以表建表"提供了从简到繁的完整工具链。理解每种选项的复制边界(尤其是 not null 始终复制、主键依赖索引复制、including all 不含索引、序列默认值的归属这四个细节),就能在任何需要克隆表结构的场景中一次写对,避免建出"看起来一样、用起来缺胳膊少腿"的隐患表。
【免费下载链接】til
:memo: Today I Learned
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



