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
  5. --删除tpcds.reason_t1表。
  6. openGauss=# DROP TABLE tpcds.reason_t1;
  8. --SELECT INTO varlist的三个位置
  9. openGauss=# SELECT * INTO @my_var FROM t;
  10. SELECT INTO
  11. openGauss=# SELECT * FROM t INTO @my_var FOR UPDATE;
  12. SELECT INTO
  13. openGauss=# SELECT * FROM t FOR UPDATE INTO @my_var;
  14. SELECT INTO
  16. --报错场景
  17. openGauss=# select * from t into @aa;
  18. ERROR:  select result consisted of more than one row
  19. openGauss=# select * from t limit 1 into @aa,@bb;
  20. ERROR:  number of variables must equal the number of columns

相关链接

SELECT

优化建议

  • DATABASE

    不建议在事务中reindex database。

  • SYSTEM

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