CREATE HYBRID TABLE¶

在当前/指定架构中创建新的混合表或替换现有表。一个表可以有多个列，每个列定义均涵盖名称、数据类型，以及列是否符合以下条件：

需要一个 NOT NULL 值。
具有默认值或为标识列。
具有任何内联约束。

备注

创建混合表时，必须在一个或多个列上定义主键约束。

您还可以使用以下 CREATE TABLE 变体来创建混合表：

:ref:`label-create_hybrid_table_as`（创建一个已填充的表；也称为 CTAS）
:ref:`label-create_hybrid_table_like`（创建现有混合表的空副本）

对于用于标准 Snowflake 表的完整 CREATE TABLE 语法，请参阅 CREATE TABLE。

另请参阅：: CREATE INDEX DROP INDEX、SHOW INDEXES、ALTER TABLE、DROP TABLE、SHOW TABLES

语法¶

CREATE [ OR REPLACE ] HYBRID TABLE [ IF NOT EXISTS ] <table_name>
  ( <col_name> <col_type>
    [
      {
        DEFAULT <expr>
        | { AUTOINCREMENT | IDENTITY }
          [
            {
              ( <start_num> , <step_num> )
              | START <num> INCREMENT <num>
            }
          ]
          [ { ORDER | NOORDER } ]
      }
    ]
    [ NOT NULL ]
    [ inlineConstraint ]
    [ COMMENT '<string_literal>' ]
    [ , <col_name> <col_type> [ ... ] ]
    [ , outoflineConstraint ]
    [ , outoflineIndex ]
    [ , ... ]
  )
  [ COMMENT = '<string_literal>' ]

Copy

其中：

inlineConstraint ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE | PRIMARY KEY | { [ FOREIGN KEY ] REFERENCES <ref_table_name> [ ( <ref_col_name> ) ] } }
  [ <constraint_properties> ]

outoflineConstraint ::=
  [ CONSTRAINT <constraint_name> ]
  { UNIQUE [ ( <col_name> [ , <col_name> , ... ] ) ]
    | PRIMARY KEY [ ( <col_name> [ , <col_name> , ... ] ) ]
    | [ FOREIGN KEY ] [ ( <col_name> [ , <col_name> , ... ] ) ]
      REFERENCES <ref_table_name> [ ( <ref_col_name> [ , <ref_col_name> , ... ] ) ]
  }
  [ <constraint_properties> ]
  [ COMMENT '<string_literal>' ]

outoflineIndex ::=
  INDEX <index_name> ( <col_name> [ , <col_name> , ... ] )
    [ INCLUDE ( <col_name> [ , <col_name> , ... ] ) ]

Copy

有关内联和外联约束的详细信息，请参阅 CREATE | ALTER TABLE ...CONSTRAINT。

必填参数¶

name

指定表的标识符（即名称）；对于在其中创建表的架构必须唯一。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅标识符要求。

col_name

指定列标识符（即名称）。表标识符的所有要求也适用于列标识符。

有关更多详细信息，请参阅标识符要求和保留和受限关键字。

备注

除了标准的保留关键字之外，以下关键字不能用作列标识符，因为它们是为 ANSI 标准上下文函数保留的：

CURRENT_DATE
CURRENT_ROLE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_USER

有关保留关键字的列表，请参阅保留和受限关键字。

col_type

指定列的数据类型。

有关可为表列指定的数据类型的详细信息，请参阅 SQL 数据类型参考。

PRIMARY KEY ( col_name [ , col_name , ... ] )

可以在列定义中（内联）或单独（外联）指定表所需的主键约束。另请参阅混合表的约束。

有关完整的语法详细信息，请参阅 CREATE | ALTER TABLE ...CONSTRAINT。有关约束的一般信息，请参阅约束。

可选参数¶

DEFAULT ... 或 . AUTOINCREMENT ...

指定在未通过 INSERT 或 CREATE HYBRID TABLE AS SELECT 语句明确指定值的情况下，是否自动在列中插入默认值：

DEFAULT expr
使用指定的表达式定义列的默认值，该表达式可以是以下任意项：

常量值。

简单表达式。

序列参考 (seq_name.NEXTVAL)。

简单表达式是返回标量值的表达式；但是，该表达式不能包含对以下内容的引用：

子查询。

汇总。

窗口函数。

外部函数。

{ AUTOINCREMENT | IDENTITY } . [ { ( start_num , step_num ) | START num INCREMENT num } ] . [ { ORDER | NOORDER } ]
当使用 AUTOINCREMENT 时，列的默认值以指定的数字开头，并且每个连续值都会自动生成。AUTOINCREMENT 列生成的值保证是唯一的。任何一对生成的值之间的差都可以保证是增量金额的倍数。

可选的 ORDER 和 NOORDER 参数指定生成的值是否提供序列语义中指定的排序保证。NOORDER 是混合表上的 AUTOINCREMENT 列的默认选项。NOORDER 通常为点写入提供明显更好的性能。

这些参数只能用于具有数值数据类型的列（NUMBER、INT、FLOAT 等）。

AUTOINCREMENT 和 IDENTITY 是同义的。如果为列指定了任一参数，则 Snowflake 将利用序列来生成列的值。有关序列的更多信息，请参阅使用序列。

start 和 step/increment 的默认值均为 1。

默认值：无值（列没有默认值）

备注

DEFAULT 和 AUTOINCREMENT 是互斥的；只能为一列指定一个值。
对于性能敏感型工作负载，NOORDER 是推荐的 AUTOINCREMENT 列选项。

CONSTRAINT ...

为表中的指定列定义内联或行外约束。混合表列的唯一性和外键约束是可选的。另请参阅混合表的约束。

有关完整的语法详细信息，请参阅 CREATE | ALTER TABLE ...CONSTRAINT。有关约束的一般信息，请参阅约束。

INDEX index_name ( col_name [ , col_name , ... ]

指定表中一个或多个列的二级索引。（当您对混合表列定义约束时，会对这些列自动创建索引。）

由于与每条记录的键的底层存储引擎关联的空间约束，因此不能对半结构化的列 (VARIANT、OBJECT、ARRAY) 定义索引。

不能在地理空间列 (VECTOR) 中定义索引。

可以在创建表时定义索引，或使用 CREATE INDEX 命令定义索引。有关创建混合表索引的更多信息，请参阅 CREATE INDEX。

INCLUDE ( col_name [ , col_name , ... ] )

为二级索引指定一个或多个包含的列。当经常进行有一系列列在投影列表但不在谓词列表中的查询时，将包含的列与二级索引一起使用可能特别有用。请参阅：创建一个带有 INCLUDE 列的二级索引。

INCLUDE 列不能是半结构化列（VARIANT、OBJECT、ARRAY）或地理空间列（GEOGRAPHY、GEOMETRY）。

只能在创建带有二级索引的表时指定 INCLUDE 列。

COMMENT = 'string_literal'

指定列、约束或表级别的注释。有关详细信息，请参阅关于约束的注释。

默认：无值

使用说明¶

要重新创建或替换混合表，请调用 GET_DDL 函数来查看混合表的定义，然后再运行 CREATE OR REPLACE HYBRID TABLE 命令。
您无法创建临时或瞬态的混合表。反之，您无法在瞬态架构或数据库中创建混合表。
架构不能包含同名的表和/或视图。创建表时：
- 如果架构中已存在同名视图，则会返回错误，并且不会创建表。
- 如果架构中已存在同名的表，则会返回错误，并且不会创建表，除非命令中包含可选的 OR REPLACE 关键字。
重要

使用 OR REPLACE 相当于对现有表执行 DROP TABLE，然后创建具有相同名称的新表。

请注意，删除和创建操作发生在单个原子操作中。这意味着与 CREATE OR REPLACE TABLE 操作并行的任何查询都使用旧的或新的表版本。

重新创建表或交换表会删除其更改数据。
与保留关键字类似，ANSI 保留函数名称（CURRENT_DATE、CURRENT_TIMESTAMP 等）不能用作列名。
关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

混合表的约束¶

创建混合表时，必须设置主键约束。

支持多列（或复合）主键。要定义多列主键，请使用以下示例中的语法，其中约束是行外约束，并引用之前为表定义的多个列：
```
CREATE OR REPLACE HYBRID TABLE ht2pk (
  col1 INTEGER NOT NULL,
  col2 INTEGER NOT NULL,
  col3 VARCHAR,
  CONSTRAINT pkey_1 PRIMARY KEY (col1, col2)
  );
```
Copy
对混合表上强制执行主键、唯一约束和外键约束。有关这些约束的限制，请参阅混合表不支持的功能和限制。
主键、唯一约束和外键约束分别构建自己的基础索引。这些索引会导致存储其他数据。在创建表时，也可以使用 outoflineIndex 语法显式定义二级（或覆盖）索引。