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 TABLECREATE TABLEDROP TABLE