SELECT INTO

功能描述

  • SELECT INTO new_table用于根据查询结果创建一个新表,并且将查询到的数据插入到新表中。数据并不返回给客户端,这一点和普通的SELECT不同。新表的字段具有和SELECT的输出字段相同的名称和数据类型。

  • SELECT INTO var_list用于把查询的结果赋值给目标变量,其中var_list可以是用户自定义变量、存储过程或函数的参数、存储程序的局部变量。

注: var_list是存储过程或函数的参数,或是存储程序的局部变量时,参考存储过程章节的语法。以下为用户自定义变量的场景。

注意事项

  • CREATE TABLE AS的作用和SELECT INTO new_table类似,且提供了SELECT INTO new_table所提供功能的超集。建议使用CREATE TABLE AS语法替代SELECT INTO new_table,因为SELECT INTO new_table不能在存储过程中使用。

  • SELECT INTO var_list中select查询结果只能返回一行,多行情况需要使用limit 1加以限制,否则报错。返回的列数需要和变量的数量保持一致,否则报错。

语法格式

  • SELECT INTO new_table语法
  1. [ WITH [ RECURSIVE ] with_query [, ...] ]
  2. SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
  3. { * | {expression [ [ AS ] output_name ]} [, ...] }
  4. INTO [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] [ TABLE ] new_table
  5. [ FROM from_item [, ...] ]
  6. [ WHERE condition ]
  7. [ GROUP BY grouping_element [, ...] ]
  8. [ HAVING condition [, ...] ]
  9. [ WINDOW {window_name AS ( window_definition )} [, ...] ]
  10. [ { UNION | INTERSECT | EXCEPT | MINUS } [ ALL | DISTINCT ] select ]
  11. [ ORDER BY {expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ]} [, ...] ]
  12. [ LIMIT { count | ALL } ]
  13. [ OFFSET start [ ROW | ROWS ] ]
  14. [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]
  15. [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT | WAIT N]} [...] ];
  • SELECT INTO var_list语法
  1. [ WITH [ RECURSIVE ] with_query [, ...] ]
  2. SELECT [/*+ plan_hint */] [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
  3. { * | {expression [ [ AS ] output_name ]} [, ...] }
  4. [into_option]
  5. [ FROM from_item [, ...] ]
  6. [ WHERE condition ]
  7. [ [ START WITH condition ] CONNECT BY [NOCYCLE] condition [ ORDER SIBLINGS BY expression ] ]
  8. [ GROUP BY grouping_element [, ...] ]
  9. [ HAVING condition [, ...] ]
  10. [ WINDOW {window_name AS ( window_definition )} [, ...] ]
  11. [ { UNION | INTERSECT | EXCEPT | MINUS } [ ALL | DISTINCT ] select ]
  12. [ ORDER BY {expression [ [ ASC | DESC | USING operator ] | nlssort_expression_clause ] [ NULLS { FIRST | LAST } ]} [, ...] ]
  13. [ LIMIT { [offset,] count | ALL } ]
  14. [ OFFSET start [ ROW | ROWS ] ]
  15. [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]
  16. [into_option]
  17. [ {FOR { UPDATE | NO KEY UPDATE | SHARE | KEY SHARE } [ OF table_name [, ...] ] [ NOWAIT | WAIT N ]} [...] ];
  18. [into_option]

参数说明

  • new_table

    new_table指定新建表的名称。

  • UNLOGGED

    指定表为非日志表。在非日志表中写入的数据不会被写入到预写日志中,这样就会比普通表快很多。但是,它也是不安全的,非日志表在冲突或异常关机后会被自动删截。非日志表中的内容也不会被复制到备用服务器中。在该类表中创建的索引也不会被自动记录。

    • 使用场景:非日志表不能保证数据的安全性,用户应该在确保数据已经做好备份的前提下使用,例如系统升级时进行数据的备份。
    • 故障处理:当异常关机等操作导致非日志表上的索引发生数据丢失时,用户应该对发生错误的索引进行重建。
  • GLOBAL | LOCAL

    创建临时表时可以在TEMP或TEMPORARY前指定GLOBAL或LOCAL关键字。如果指定GLOBAL关键字,openGauss会创建全局临时表,否则openGauss会创建本地临时表。

  • TEMPORARY | TEMP

    如果指定TEMP或TEMPORARY关键字,则创建的表为临时表。临时表分为全局临时表和本地临时表两种类型。创建临时表时如果指定GLOBAL关键字则为全局临时表,否则为本地临时表。

    全局临时表的元数据对所有会话可见,会话结束后元数据继续存在。会话与会话之间的用户数据、索引和统计信息相互隔离,每个会话只能看到和更改自己提交的数据。全局临时表有两种模式:一种是基于会话级别的(ON COMMIT PRESERVE ROWS),当会话结束时自动清空用户数据;一种是基于事务级别的(ON COMMIT PRESERVE ROWS),当执行commit或rollback时自动清空用户数据。建表时如果没有指定ON COMMIT选项,则缺省为会话级别。与本地临时表不同,全局临时表建表时可以指定非pg_temp_开头的schema。

    由于临时表只在当前会话创建,对于涉及对临时表操作的DDL语句,会产生DDL失败的报错。因此,建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。

    SELECT INTO - 图1 须知:

    • 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见,因此,不建议用户在日常操作中手动删除以pg_tem、pg_toast_temp开头的schema。
    • 如果建表时不指定TEMPORARY/TEMP关键字,而指定表的schema为当前会话的pg_temp_开头的schema,则此表会被创建为临时表。
    • ALTER/DROP全局临时表和索引,如果其它会话正在使用它,禁止操作。
    • 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。
  • into_option

    • INTO语句可以出现在三个位置,在同一个SELECT语句中只能有一个into子句。
    • 需要在b模式数据库,并且guc参数enable_set_variable_b_format设置为on的时候,才能正确识别用户自定义变量。 into_option: { INTO var_name [, var_name] … }

SELECT INTO - 图2 说明: SELECT INTO的其它参数可参考SELECT的参数说明

参数var_name可参考SET中对var_name的说明。

示例

  1. --将tpcds.reason表中r_reason_sk小于5的值加入到新建表中。
  2. openGauss=# SELECT * INTO tpcds.reason_t1 FROM tpcds.reason WHERE r_reason_sk < 5;
  3. INSERT 0 6
  4. --删除tpcds.reason_t1表。
  5. openGauss=# DROP TABLE tpcds.reason_t1;
  6. --SELECT INTO varlist的三个位置
  7. openGauss=# SELECT * INTO @my_var FROM t;
  8. SELECT INTO
  9. openGauss=# SELECT * FROM t INTO @my_var FOR UPDATE;
  10. SELECT INTO
  11. openGauss=# SELECT * FROM t FOR UPDATE INTO @my_var;
  12. SELECT INTO
  13. --报错场景
  14. openGauss=# select * from t into @aa;
  15. ERROR: select result consisted of more than one row
  16. openGauss=# select * from t limit 1 into @aa,@bb;
  17. ERROR: number of variables must equal the number of columns

相关链接

SELECT

优化建议

  • DATABASE

    不建议在事务中reindex database。

  • SYSTEM

    不建议在事务中reindex系统表。