↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 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.5 / 6.4
历史版本。 PostgreSQL 12 已结束支持。 2024-11-21. 请参阅 当前版本手册.

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

如果指定,该表将创建为不记录 WAL 的表。详见 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(见第 35 章)和 PL/pgSQL(见第 42 章)中的用法。PostgreSQL 使用 SELECT INTO 表示创建表则是历史遗留用法。对于新代码,最好为此目的使用 CREATE TABLE AS。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.