PostgreSQL 16 文档: SELECT INTO

SELECT INTO
上一个	向上	SQL 命令	主页	下一个

SELECT INTO

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

语法

[ 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 或 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（请参阅第 36 章）和 PL/pgSQL（请参阅第 43 章）中的用法。 PostgreSQL 使用 SELECT INTO 来表示表创建是历史性的。一些其他 SQL 实现也以这种方式使用 SELECT INTO（但大多数 SQL 实现都支持 CREATE TABLE AS）。除了此类兼容性考虑因素之外，最好在新代码中将 CREATE TABLE AS 用于此目的。

另请参阅

CREATE TABLE AS