PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

SELECT INTO

SELECT INTO — 从一个查询的结果定义一个新表

Synopsis

[ WITH [ RECURSIVE ] with_query [, ...] ]
SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
    [ { * | expression [ [ AS ] output_name ] } [, ...] ]
    INTO [ TEMPORARY | TEMP | UNLOGGED ] [ TABLE ] new_table
    [ FROM from_item [, ...] ]
    [ WHERE condition ]
    [ GROUP BY expression [, ...] ]
    [ HAVING condition ]
    [ WINDOW window_name AS ( window_definition ) [, ...] ]
    [ { UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] select ]
    [ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start [ ROW | ROWS ] ]
    [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]
    [ FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ] [...] ]

描述

SELECT INTO 创建一个新表,并用一个查询计算出的数据填充它。与普通的 SELECT 不同,这些数据不会被返回给客户端。新表的列具有与该 SELECT 的输出列相关联的名称和数据类型。

参数

TEMPORARY or TEMP

如果指定了该参数,表将被创建为临时表。详见 CREATE TABLE。

UNLOGGED

如果指定了该参数,表将被创建为非日志表。详见 CREATE TABLE。

new_table

要创建的表的名称(可以用模式限定)。

所有其他参数都在 SELECT 中有详细描述。

注记

CREATE TABLE AS 在功能上与 SELECT INTO 类似。推荐使用 CREATE TABLE AS 语法,因为这种形式的 SELECT INTO 在 ECPG 或 PL/pgSQL 中不可用,因为它们对 INTO 子句的解释不同。此外,CREATE TABLE AS 提供了 SELECT INTO 所提供功能的一个超集。

与 CREATE TABLE AS 不同,SELECT INTO 不允许用 USING method 来指定表的访问方法等属性,也不允许用 TABLESPACE tablespace_name 来指定表的表空间。如有必要,请使用 CREATE TABLE AS。因此,新表将采用默认的表访问方法。更多信息请参见 default_table_access_method。

示例

创建一个新表 films_recent,它只包含表 films 中最近的条目:

SELECT * INTO films_recent FROM films WHERE date_prod >= '2002-01-01';

兼容性

SQL 标准使用 SELECT INTO 来表示把值选择到宿主程序的标量变量中,而不是创建一个新表。这确实也是 ECPG(参见 Chapter 34)和 PL/pgSQL(参见 Chapter 41)中的用法。PostgreSQL 用 SELECT INTO 表示表创建是一种历史用法。一些其他 SQL 实现也以这种方式使用 SELECT INTO(但大多数 SQL 实现转而支持 CREATE TABLE AS)。撇开这类兼容性考虑不谈,在新代码中最好使用 CREATE TABLE AS 来达到此目的。

另请参阅

CREATE TABLE AS