PostgreSQL 17 文档: 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 中的近期条目组成的创建新表 films_recent

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

兼容性

SQL 标准使用 SELECT INTO 来表示选举值到宿主机程序的标量变量中，而不是创建新表。事实上这是在 ECPG（参见第 34 章）和 PL/pgSQL（参见第 41 章）中找到的用法。PostgreSQL 使用 SELECT INTO 来表示表创建是一个历史事实。一些其他 SQL 实现也使用 SELECT INTO 以这种方式（但大多数 SQL 实现支持 CREATE TABLE AS 代替）。除了此类兼容性注意事项之外，最好在新代码中使用 CREATE TABLE AS 进行此操作。

另请参见

CREATE TABLE AS