PostgreSQL 从既有表结构创建新表:CREATE TABLE AS 与 CREATE TABLE LIKE 完全指南

  • 文档
  • 教程
  • 知识库

【免费下载链接】til

:memo: Today I Learned

项目地址: https://gitcode.com/gh_mirrors/ti/til
点击查看 免费下载

在 PostgreSQL 日常开发中,常常需要以一张现有表为模板快速创建一张结构相同(或结构近似)的新表——例如为测试搭建一张影子表、为临时计算建立同构中间表、或为归档拆分出一张字段一致的副本。本文基于本仓库 postgres/create-a-table-from-the-structure-of-another.md 的核心内容,系统讲解两种主流实现方式:CREATE TABLE AS 与 CREATE TABLE (LIKE ...),并深入展开 INCLUDING 系列选项的复制范围、底层行为与实战陷阱,读完即可在 psql 中直接落地使用。

一、两种方式快速对比

维度CREATE TABLE AS ... WITH NO DATACREATE 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 constraintscheck 约束(not null 始终复制,见下)
including indexes源表的索引;主键与唯一约束的支撑索引也会随之重建
including identityidentity 列的定义(复制表会获得全新的独立序列)
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 脚本,适合"把表结构归档到迁移脚本/代码仓库"的静态场景。

七、注意事项与最佳实践小结

  1. 明确复制目标:只要列结构,用 create table as ... with no data 即可;要完整结构,优先 create table (like ...) 并组合 including 选项。
  2. 主键与唯一约束靠索引复制:想保留这两类约束,必须带 including indexes;including constraints 只管 check(not null 则始终复制)。
  3. including all 不包含索引:需要"一切"时写 including all including indexes。
  4. 序列归属要心里有数:serial 源表的默认值复制后与原表共享序列;identity 源表配合 including identity 可获得独立序列。新表设计建议参考 postgres/generate-modern-primary-key-columns.md 改用 identity 列。
  5. 外键不会被复制:复制表与其他表的引用关系需重建,可参考 postgres/references-target-primary-key-by-default.md 了解外键默认引用主键的写法。
  6. 留意索引重名:复制索引沿用原名,同名会报错,必要时手动重建并改名。
  7. 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

项目地址: https://gitcode.com/gh_mirrors/ti/til
点击查看 免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址