From 32ada8d1d4fb8bd306f9ca8f03e1ed1cb3c4f75d Mon Sep 17 00:00:00 2001 From: wangzhijun2018 Date: Thu, 6 Aug 2020 17:18:17 +0800 Subject: [PATCH] update CREATE-TABLE-AS & SELECT-INTO for Global Temporary Table --- .../zh/docs/Developerguide/CREATE-TABLE-AS.md | 29 +++++++++++++++- content/zh/docs/Developerguide/SELECT-INTO.md | 34 ++++++++++++++++--- 2 files changed, 58 insertions(+), 5 deletions(-) diff --git a/content/zh/docs/Developerguide/CREATE-TABLE-AS.md b/content/zh/docs/Developerguide/CREATE-TABLE-AS.md index 39b3b6162..3bfa06e36 100644 --- a/content/zh/docs/Developerguide/CREATE-TABLE-AS.md +++ b/content/zh/docs/Developerguide/CREATE-TABLE-AS.md @@ -16,9 +16,10 @@ CREATE TABLE AS对源表进行一次查询，然后将数据写入新表中， ## 语法格式 ``` -CREATE [ UNLOGGED ] TABLE table_name +CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE table_name [ (column_name [, ...] ) ] [ WITH ( {storage_parameter = value} [, ... ] ) ] + [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ COMPRESS | NOCOMPRESS ] [ TABLESPACE tablespace_name ] AS query @@ -34,6 +35,25 @@ CREATE [ UNLOGGED ] TABLE table_name - 使用场景：非日志表不能保证数据的安全性，用户应该在确保数据已经做好备份的前提下使用，例如系统升级时进行数据的备份。 - 故障处理：当异常关机等操作导致非日志表上的索引发生数据丢失时，用户应该对发生错误的索引进行重建。 +- **GLOBAL | LOCAL** + + 创建临时表时可以在TEMP或TEMPORARY前指定GLOBAL或LOCAL关键字。如果指定GLOBAL关键字，openGauss会创建全局临时表，否则**openGauss**会创建本地临时表。 + +- **TEMPORARY | TEMP** + + 如果指定TEMP或TEMPORARY关键字，则创建的表为临时表。临时表分为全局临时表和本地临时表两种类型。创建临时表时如果指定GLOBAL关键字则为全局临时表，否则为本地临时表。 + + 全局临时表的元数据对所有会话可见，会话结束后元数据继续存在。会话与会话之间的用户数据、索引和统计信息相互隔离，每个会话只能看到和更改自己提交的数据。全局临时表有两种模式：一种是基于会话级别的(ON COMMIT PRESERVE ROWS), 当会话结束时自动清空用户数据；一种是基于事务级别的(ON COMMIT DELETE ROWS), 当执行commit或rollback时自动清空用户数据。建表时如果没有指定ON COMMIT选项，则缺省为会话级别。与本地临时表不同，全局临时表建表时可以指定非pg_temp_开头的schema。 + + 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 + + > ![](public_sys-resources/icon-notice.gif)**须知：** + > + > - 本地临时表通过每个会话独立的以pg\_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg\_temp，pg\_toast\_temp开头的schema。 + > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg\_temp\_开头的schema，则此表会被创建为临时表。 + > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 + > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 + - **table\_name** 要创建的表名。 @@ -80,6 +100,13 @@ CREATE [ UNLOGGED ] TABLE table_name 取值范围：10000\~60000 +- **ON COMMIT \{ PRESERVE ROWS | DELETE ROWS | DROP \}** + + ON COMMIT选项决定在事务中执行创建临时表操作，当事务提交时，此临时表的后续操作。有以下三个选项，当前支持PRESERVE ROWS和DELETE ROWS选项。 + + - PRESERVE ROWS（缺省值）：提交时不对临时表做任何操作，临时表及其表数据保持不变。 + - DELETE ROWS：提交时删除临时表中数据。 + - DROP：提交时删除此临时表。（只支持本地临时表，不支持全局临时表） - **COMPRESS / NOCOMPRESS** diff --git a/content/zh/docs/Developerguide/SELECT-INTO.md b/content/zh/docs/Developerguide/SELECT-INTO.md index 5aa73250e..c03c75643 100644 --- a/content/zh/docs/Developerguide/SELECT-INTO.md +++ b/content/zh/docs/Developerguide/SELECT-INTO.md @@ -16,7 +16,7 @@ CREATE TABLE AS的作用和SELECT INTO类似，且提供了SELECT INTO所提供 [ WITH [ RECURSIVE ] with_query [, ...] ] SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] { * | {expression [ [ AS ] output_name ]} [, ...] } - INTO [ UNLOGGED ] [ TABLE ] new_table + INTO [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] [ TABLE ] new_table [ FROM from_item [, ...] ] [ WHERE condition ] [ GROUP BY expression [, ...] ] @@ -32,12 +32,38 @@ SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] ## 参数说明 -**INTO \[ UNLOGGED \] \[ TABLE \] new\_table** - -UNLOGGED指定表为非日志表。在非日志表中写入的数据不会被写入到预写日志中，这样就会比普通表快很多。但是，它也是不安全的，非日志表在冲突或异常关机后会被自动删截。非日志表中的内容也不会被复制到备用服务器中。在该类表中创建的索引也不会被自动记录。 +**INTO \[ \[ GLOBAL | LOCAL \] \{ TEMPORARY | TEMP \} | UNLOGGED \] \[ TABLE \] 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 DELETE ROWS), 当执行commit或rollback时自动清空用户数据。建表时如果没有指定ON COMMIT选项，则缺省为会话级别。与本地临时表不同，全局临时表建表时可以指定非pg_temp_开头的schema。 + + 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 + + > ![](C:/Users/w00323480/Downloads/opengauss-docs-master/docs/content/zh/docs/Developerguide/public_sys-resources/icon-notice.gif)**须知：** + > + > - 本地临时表通过每个会话独立的以pg\_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg\_temp，pg\_toast\_temp开头的schema。 + > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg\_temp\_开头的schema，则此表会被创建为临时表。 + > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 + > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 + >![](public_sys-resources/icon-note.gif) **说明：** >SELECT INTO的其它参数可参考SELECT的[参数说明](SELECT.md#zh-cn_topic_0237122184_zh-cn_topic_0059777449_sa812f65b8e8c4c638ec7840697222ddc)。 -- Gitee