PostgreSQL：文档：16：SELECT INTO

文档 → PostgreSQL 16

支持的版本：当前 (16) / 15 / 14 / 13 / 12

开发版本：devel

不支持的版本：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

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

上一个	向上	下一个
SELECT	主页	SET

提交更正

如果您在文档中看到任何不正确的内容，与您对特定功能的体验不符或需要进一步澄清，请使用此表单报告文档问题。