CREATE TABLE AS

根据查询结果定义一个新表。

概要

CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE table_name
        [ (column_name [, ...] ) ]
        [ USING MARS2 ]
        [ WITH ( storage_parameter [= value] [, ... ] ) | WITHOUT OIDS ]
        [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
        [ TABLESPACE tablespace_name ]
        AS query
        [ WITH [ NO ] DATA ]
        [ DISTRIBUTED BY (column [, ... ] ) | DISTRIBUTED RANDOMLY | DISTRIBUTED REPLICATED ]

其中 storage_parameter 是：

   appendoptimized={TRUE|FALSE}
   blocksize={8192-2097152}
   orientation={COLUMN|ROW}
   compresstype={ZLIB|ZSTD|QUICKLZ|RLE_TYPE|NONE}
   compresslevel={1-19 | 1}
   fillfactor={10-100}
   [oids=FALSE]

描述

CREATE TABLE AS 创建一个表，并用 SELECT 命令计算的数据填充该表。表列具有与 SELECT 的输出列关联的名称和数据类型，但是您可以通过提供新列名称的显式列表来覆盖列名称。

CREATE TABLE AS 创建一个新表并仅对查询进行一次取值以填充一次新表。新表将不会跟踪对查询源表的后续更改。

参数

GLOBAL | LOCAL

忽略兼容性。这些关键字已弃用。

TEMPORARY | TEMP

如果指定，则将新表创建为临时表。临时表在会话结束时或在当前事务结束时自动删除（请参见 ON COMMIT）。临时表存在时，具有相同名称的现有永久表在当前会话中不可见，除非使用模式限定名称引用它们。在临时表上创建的所有索引也会自动成为临时索引。

UNLOGGED

如果指定，该表将创建为未记录表。写入未记录表的数据不会写入预写（WAL）日志，这使它们比普通表快得多。但是，未记录表的内容不会复制到 Mirror 实例。同样，未记录的表也不是崩溃安全的。Segment 实例崩溃或异常关闭后，该 Segment 上未记录表的数据将被截断。在未记录表上创建的所有索引也会自动成为未记录索引。

table_name

要创建的新表的名称（可以由模式指定）。

column_name

新表中的列名。如果未提供列名，则它们取自查询的输出列名。

WITH (storage_parameter=value )

WITH 子句可用于设置表或其索引的存储选项。请注意，您还可以通过在分区规范中声明 WITH 子句，在特定分区或子分区上设置不同的存储参数。可以使用以下存储选项：
- appendoptimized — 设置为 TRUE 可将表创建为追加优化的表。如果为 FALSE 或未声明，则将表创建为常规堆存储表。
- blocksize — 设置为表中每个块的大小（以字节为单位）。 blocksize 必须介于 8192 和 2097152 字节之间，并且是 8192 的倍数。默认值为 32768。该参数仅在 appendoptimized = TRUE 时生效。
- orientation — 设置为 column 以用于列式存储，或设置为 row（默认）以用于行式存储。仅当 appendoptimized = TRUE 时，此选项才有效。堆存储表只能是面向行的。
- compresstype — 设置为 ZLIB（默认值），ZSTD 或 QUICKLZ1 以指定使用的压缩类型。值 NONE 禁用压缩。 ZSTD 提供速度或良好的压缩率，可通过 compresslevel 选项进行调整。提供 QuickLZ 和 ZLIB 是为了向后兼容。在通常的工作负载上，ZSTD 的性能优于这些压缩类型。仅当appendoptimized = TRUE时，compresstype 选项才有效。
- compresslevel — 对于附加优化表的 ZSTD 压缩，请将其设置为 1（最快压缩）到 19（最高压缩率）之间的整数值。对于 ZLIB 压缩，有效范围是 1 到 9。 QuickLZ 压缩级别只能设置为 1。如果未声明，则默认值为 1。 compresslevel 选项仅在 appendoptimized = TRUE 时有效。
- fillfactor — 有关此索引存储参数的更多信息，请参见 CREATE INDEX。
- oids=FALSE — 这是默认值，每个数据行内没有分配 oid。 YMatrix 强烈建议您在创建表时不要启用 OIDS。在大型表上（例如典型的 YMatrix 数据库系统中的表），对表行使用 OID 可能会导致 32 位 OID 计数器的折回。一旦计数器回绕，就不能再认为 OID 是唯一的，这不仅使它们对用户应用程序无用，而且还会在 YMatrix 数据库系统 catalog 表中引起问题。此外，从表中排除 OID 会使表每行存储在磁盘上所需的空间减少了每行 4 个字节，从而略微提高了性能。面向列的表不允许使用 OIDS。 ON COMMIT
可以使用 ON COMMIT 控制事务块末尾的临时表的行为。这三个选项是：
PRESERVE ROWS — 临时表的事务结束时不会采取任何特殊操作。这是默认行为。
DELETE ROWS — 临时表中的所有行将在每个事务块的末尾删除。本质上，每次提交都会自动执行一次 TRUNCATE。
DROP — 临时表将在当前事务块的末尾删除。

TABLESPACE tablespace_name

tablespace_name 参数是要在其中创建新表的表空间的名称。如果未指定，则使用数据库的默认表空间。

AS query

SELECT， TABLE 或 VALUES 命令，或运行准备的 SELECT 或 VALUES 查询的 EXECUTE 命令。

DISTRIBUTED BY ({column [opclass]}, [ ... ] )

DISTRIBUTED RANDOMLY

DISTRIBUTED REPLICATED

用于声明表的 YMatrix 数据库分发策略。 DISTRIBUTED BY 使用具有一个或多个声明为分发键的列的哈希分发。为了获得最均匀的数据分配，分发键应为表的主键或唯一列（或一组列）。如果无法做到这一点，则可以选择 DISTRIBUTED RANDOMLY，它将数据轮询发送到 Segment 实例。
DISTRIBUTED REPLICATED 将表中的所有行复制到所有 YMatrix 数据库 Segment。它不能与分区表或从其他表继承的表一起使用。
如果在创建表时未指定 DISTRIBUTED BY 子句，则 YMatrix 数据库服务器配置参数 gp_create_table_random_default_distribution 将控制默认表分发策略。如果未指定分发策略，YMatrix 数据库将遵循以下规则来创建表：
- 如果 Postgres 查询优化器创建了表，并且该参数的值是 off，则根据命令确定表分配策略。
- 如果 Postgres 查询优化器创建了表，并且该参数的值为 on，则表分配策略是随机的。
- 如果 GPORCA 创建表，则表分配策略是随机的。参数值无效。

注解

该命令在功能上类似于 SELECT INTO，但它是首选的，因为它不太可能与 SELECT INTO 语法的其他用法混淆。此外，CREATE TABLE AS 提供了 SELECT INTO 提供的功能的超集。

CREATE TABLE AS 可用于从外部表数据源快速加载数据。请参阅 CREATE EXTERNAL TABLE。

示例

创建一个新表 films_recent，该表仅包含表 films 中的最新条目：

CREATE TABLE films_recent AS SELECT * FROM films WHERE 
date_prod >= '2007-01-01';

使用预编译语句创建一个新的临时表 films_recent，该表仅包含表 films 中的最新条目。新表具有 OID，并将在提交时删除：

PREPARE recentfilms(date) AS SELECT * FROM films WHERE 
date_prod > $1;
CREATE TEMP TABLE films_recent ON COMMIT DROP AS 
EXECUTE recentfilms('2007-01-01');

兼容性

CREATE TABLE AS 符合 SQL 标准，但以下情况除外：

该标准要求在子查询子句两边加上括号；在 YMatrix 数据库中，这些括号是可选的。
该标准定义了 WITH [NO] DATA 子句；YMatrix 数据库当前未实现此功能。 YMatrix 数据库提供的行为等同于标准的 WITH DATA 情况。可以通过将 LIMIT 0 附加到查询来模拟 WITH NO DATA。
YMatrix 数据库对临时表的处理方式与标准处理方式有所不同。有关详细信息，请参见 CREATE TABLE。
WITH 子句是 YMatrix 数据库扩展。 storage 参数和 OIDs 都不在标准中。创建 OID 系统列的语法已被弃用。
表空间的 YMatrix 数据库概念不是该标准的一部分。 TABLESPACE 子句是扩展。

另见

ALTER TABLE，CREATE TABLE，DROP TABLE