↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 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 / 7.0 / 6.4

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权限。

参数

GLOBAL 或 LOCAL #

出于兼容性考虑,这些关键字会被忽略。它们的用法已废弃;详见CREATE TABLE。

TEMPORARY 或 TEMP #

如果指定,将把该表创建为临时表。详见CREATE TABLE。

UNLOGGED #

如果指定,该表将创建为不记录 WAL 的表。详见CREATE TABLE。

IF NOT EXISTS #

如果已存在同名关系,则不抛出错误,而是发出一条提示,并保持现有关系不变。

table_name #

要创建的表名(可选地带模式限定)。

column_name #

新表中某一列的名称。如果未提供列名,则采用查询输出列的列名。

USING method #

这个可选子句指定用于存储新表内容的表访问方法;该方法必须是 TABLE类型的访问方法。详见第 62 章。如果未指定此选项,则会为新表选择默认的表访问方法。详见default_table_access_method。

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

这个子句为新表指定可选的存储参数;更多信息见CREATE TABLE文档中的Storage Parameters。为保持向后兼容,表的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 #

一个SELECT、TABLE或 VALUES命令,或者一个EXECUTE 命令,用于执行一条已预备的SELECT、TABLE或VALUES查询。

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子句是一种扩展。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。