Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14

CREATE TABLE AS

名称

CREATE TABLE AS -- 从一条查询的结果中定义一个新表

大纲

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

描述

CREATE TABLE AS创建一个表并且用来自 SELECT命令的结果填充该表。该表的字段和 SELECT输出字段的名字及数据类型相关。 (不过你可以通过明确地给出一个字段名字列表来覆盖 SELECT 输出字段的名字。)

CREATE TABLE AS和创建视图有点像, 不过两者之间实在是差异很大:它创建一个新表并且只对查询计算一次来填充这个新表。 新表不能跟踪源表的变化。相比之下,每次做查询的时候, 视图都重新计算定义它的SELECT语句。

参数

GLOBALLOCAL

忽略,仅仅为了兼容性而存在。这些关键字的使用已经废弃了; 请参考CREATE TABLE获取细节。

TEMPORARYTEMP

如果声明了这个选项,则该表作为临时表创建。 参阅CREATE TABLE获取细节。

UNLOGGED

如果声明了这个选项,则该表作为非日志表创建。 参阅CREATE TABLE获取细节。

table_name

要创建的表名(可以用模式修饰)。

column_name

新表中字段的名称。如果没有提供字段名字,那么就从查询的输出字段名中获取。

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

这个子句为新表指定了可选的存储参数;参见存储参数获取更多信息。 WITH子句还可以包含OIDS=TRUE(或只是OIDS) 来为新表中的行分配和存储 OID(对象表示符);或者用OIDS=FALSE 表示不分配 OID 。参见CREATE TABLE获取更多信息。

WITH OIDS
WITHOUT OIDS

这些是反对使用的、分别等价于WITH (OIDS)WITH (OIDS=FALSE)的语法。如果你希望同时给出OIDS 设置和存储参数,必须使用WITH ( ... )语法;见下文。

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功能的超集。

PostgreSQL 8.0 之前, CREATE TABLE AS总是在它创建的表中包含 OID , 而在PostgreSQL 8.0 里,CREATE TABLE AS 命令允许明确声明是否应该包含 OID 。如果没有明确声明是否应该包含 OID , 那么使用配置变量default_with_oids的设置。 到了PostgreSQL这个变量缺省为假, 缺省行为和 8.0 之前的版本不同。因此,那些要求CREATE TABLE AS 创建的表包含 OID 的应用应该明确声明WITH (OIDS)以确保要求的行为。

例子

创建一个只包含表films中最近的记录的新表films_recent

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

要完整的拷贝一个表,也可以使用TABLE命令的简易形式:

CREATE TABLE films2 AS
  TABLE films;

使用预备语句创建一个只包含表films中最近的记录的新临时表 films_recent,该临时表包含 OID 并且在事务结束时将被删除:

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

兼容性

CREATE TABLE AS兼容SQL标准, 下面是非标准的扩展:

又见

CREATE MATERIALIZED VIEW, CREATE TABLE, EXECUTE, SELECT, SELECT INTO, VALUES