支持的版本:当前 (17) / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

CREATE TABLE AS

CREATE TABLE AS — 从查询结果定义新表

概要

CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name
    [ (column_name [, ...] ) ]
    [ USING method ]
    [ WITH ( storage_parameter [= value] [, ... ] ) | WITHOUT OIDS ]
    [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
    [ TABLESPACE tablespace_name ]
    AS query
    [ WITH [ NO ] DATA ]

描述

CREATE TABLE AS 创建一个表,并使用 SELECT 命令计算的数据填充该表。表列具有与 SELECT 的输出列关联的名称和数据类型(除非您通过提供新的列名称的显式列表来覆盖列名称)。

CREATE TABLE AS 与创建视图有些相似,但它实际上是完全不同的:它创建一个新表,并且只计算一次查询来初始填充新表。新表不会跟踪查询源表的后续更改。相反,视图会在每次查询时重新计算其定义的 SELECT 语句。

CREATE TABLE AS 需要对用于该表的模式具有 CREATE 权限。

参数

GLOBALLOCAL

为了兼容性而被忽略。不建议使用这些关键字;有关详细信息,请参阅 CREATE TABLE

TEMPORARYTEMP

如果指定,则将表创建为临时表。有关详细信息,请参阅 CREATE TABLE

UNLOGGED

如果指定,则将表创建为未记录的表。有关详细信息,请参阅 CREATE TABLE

IF NOT EXISTS

如果已存在同名的关系,则不会抛出错误;仅发出通知,并且不会修改表。

table_name

要创建的表的名称(可选地限定架构)。

column_name

新表中的列的名称。如果未提供列名称,则从查询的输出列名称获取。

USING method

此可选子句指定用于存储新表内容的表访问方法;该方法需要是 TABLE 类型的访问方法。有关详细信息,请参阅 第 61 章。如果未指定此选项,则为新表选择默认的表访问方法。有关详细信息,请参阅 default_table_access_method

WITH ( storage_parameter [= value] [, ... ] )

此子句指定新表的可选存储参数;有关详细信息,请参阅 存储参数 中的 CREATE TABLE 文档。为了向后兼容,表的 WITH 子句还可以包括 OIDS=FALSE,以指定新表的行不应包含 OID(对象标识符),不再支持 OIDS=TRUE

WITHOUT OIDS

这是用于声明表 WITHOUT OIDS 的向后兼容的语法,不再支持创建 WITH OIDS 的表。

ON COMMIT

可以使用 ON COMMIT 控制事务块末尾临时表的行为。有三个选项:

PRESERVE ROWS

在事务结束时不会采取任何特殊操作。这是默认行为。

DELETE ROWS

临时表中的所有行将在每个事务块的末尾删除。本质上,在每次提交时都会执行自动 TRUNCATE

DROP

临时表将在当前事务块的末尾删除。

TABLESPACE tablespace_name

tablespace_name 是要在其中创建新表的表空间名称。如果未指定,则会查询 default_tablespace,如果表是临时的,则会查询 temp_tablespaces

query

SELECTTABLEVALUES 命令,或者运行准备好的 SELECTTABLEVALUES 查询的 EXECUTE 命令。

WITH [ NO ] DATA

此子句指定是否应将查询生成的数据复制到新表中。如果不是,则仅复制表结构。默认设置为复制数据。

注释

此命令在功能上与 SELECT INTO 类似,但首选此命令,因为它不太可能与其他使用 SELECT INTO 语法的用法混淆。此外,CREATE TABLE AS 提供了 SELECT INTO 提供的功能的超集。

示例

创建一个新表 films_recent,其中仅包含表 films 中的最新条目

CREATE TABLE films_recent AS
  SELECT * FROM films WHERE date_prod >= '2002-01-01';

要完全复制一个表,也可以使用 TABLE 命令的简短形式

CREATE TABLE films2 AS
  TABLE films;

创建一个新的临时表 films_recent,其中仅包含表 films 中的最新条目,使用预处理语句。新表将在提交时被删除

PREPARE recentfilms(date) AS
  SELECT * FROM films WHERE date_prod > $1;
CREATE TEMP TABLE films_recent ON COMMIT DROP AS
  EXECUTE recentfilms('2002-01-01');

兼容性

CREATE TABLE AS 符合SQL标准。以下是非标准扩展

  • 该标准要求在子查询子句周围加上括号;在 PostgreSQL 中,这些括号是可选的。

  • 在该标准中,需要 WITH [ NO ] DATA 子句;在 PostgreSQL 中,它是可选的。

  • PostgreSQL 处理临时表的方式与标准相当不同;有关详细信息,请参阅 CREATE TABLE

  • WITH 子句是一个 PostgreSQL 扩展;存储参数不在标准中。

  • PostgreSQL 的表空间概念不是标准的一部分。因此,子句 TABLESPACE 是一个扩展。

提交更正

如果您在文档中发现任何不正确、与您特定功能的体验不符或需要进一步澄清的地方,请使用 此表单 来报告文档问题。