CREATE TABLE

更新时间：2026-05-31 10:28:12

描述

该语句用来在数据库中创建一张新表。

语法

CREATE TABLE [IF NOT EXISTS] table_name
      (table_definition_list) [table_option_list] [partition_option] [AS] select;

CREATE TABLE [IF NOT EXISTS] table_name
      LIKE table_name;

table_definition_list:
    table_definition [, table_definition ...]

table_definition:
      column_definition
    | [CONSTRAINT [constraint_name]] PRIMARY KEY index_desc
    | [CONSTRAINT [constraint_name]] UNIQUE {INDEX | KEY} 
            [index_name] index_desc
    | [CONSTRAINT [constraint_name]] FOREIGN KEY 
            [index_name] index_desc 
            REFERENCES reference_definition 
            [match_action][opt_reference_option_list]
    | {INDEX | KEY} [index_name] index_desc
    | [CONSTRAINT [constraint_name]] CHECK(expression) constranit_state

column_definition_list:
    column_definition [, column_definition ...]

column_definition:
     column_name data_type
         [DEFAULT const_value] [AUTO_INCREMENT]
         [NULL | NOT NULL] [[PRIMARY] KEY] [UNIQUE [KEY]] comment
   | column_name data_type
         [GENERATED ALWAYS] AS (expr) [VIRTUAL | STORED]
         [opt_generated_column_attribute] 

index_desc:
   (column_desc_list) [index_type] [index_option_list]

match_action:
   MATCH {SIMPLE | FULL | PARTIAL}

opt_reference_option_list:
   reference_option [,reference_option ...]

reference_option:
   ON {DELETE | UPDATE} {RESTRICT | CASCADE | SET NULL | NO ACTION | SET DEFAULT}

column_desc_list:
    column_desc [, column_desc ...]

column_desc:
     column_name [(length)] [ASC | DESC]

index_type:
    USING BTREE

index_option_list:
    index_option [ index_option ...]

index_option:
      [GLOBAL | LOCAL]
    | block_size
    | compression
    | STORING(column_name_list)
    | comment

table_option_list:
    table_option [ table_option ...]

table_option:
      [DEFAULT] {CHARSET | CHARACTER SET} [=] charset_name
    | [DEFAULT] COLLATE [=] collation_name
    | table_tablegroup
    | block_size
    | compression
    | AUTO_INCREMENT [=] INT_VALUE
    | comment
    | DUPLICATE_SCOPE [=] "none|cluster"
    | LOCALITY [=] "locality description"
    | ROW_FORMAT [=] REDUNDANT|COMPACT|DYNAMIC|COMPRESSED|DEFAULT
    | PCTFREE [=] num
    | parallel_clause

parallel_clause:
    {NOPARALLEL | PARALLEL integer}

partition_option:
      PARTITION BY HASH(expression)
      [subpartition_option] PARTITIONS partition_count
    | PARTITION BY KEY([column_name_list])
      [subpartition_option] PARTITIONS partition_count
    | PARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
      [subpartition_option] (range_partition_list)
    | PARTITION BY LIST {(expression) | COLUMNS (column_name_list)}
      [subpartition_option] PARTITIONS partition_count

subpartition_option:
      SUBPARTITION BY HASH(expression)
      SUBPARTITIONS subpartition_count
    | SUBPARTITION BY KEY(column_name_list)
      SUBPARTITIONS subpartition_count
    | SUBPARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
      (range_subpartition_list)
    | SUBPARTITION BY LIST(expression)

range_partition_list:
    range_partition [, range_partition ...]

range_partition:
    PARTITION partition_name
    VALUES LESS THAN {(expression_list) | MAXVALUE}

range_subpartition_list:
    range_subpartition [, range_subpartition ...]

range_subpartition:
    SUBPARTITION subpartition_name
    VALUES LESS THAN {(expression_list) | MAXVALUE}

expression_list:
    expression [, expression ...]

column_name_list:
    column_name [, column_name ...]

partition_name_list:
    partition_name [, partition_name ...]

partition_count | subpartition_count:
    INT_VALUE

参数说明

参数	描述
PRIMARY KEY	为创建的表指定主键。如果不指定，则使用隐藏主键。特别地，OceanBase 数据库不支持修改表的主键或通过 `ALTER TABLE` 语句为表添加主键，因此推荐您在创建表时指定好表的主键。
FOREIGN KEY	为创建的表指定外键。如果不指定外键名，则会使用表名 + `OBFK` + 创建时间命名。（例如，在 2021 年 8 月 1 日 00:00:00 为 `t1` 表创建的外键名称为 `t1_OBFK_1627747200000000`）。
KEY \| INDEX	为创建的表指定键或索引。如果不指定索引名，则会使用索引引用的第一列作为索引名，如果命名存在重复，则会使用下划线（_）+ 序号的方式命名。（例如，使用 `c1` 列创建的索引如果命名重复，则会将索引命名为 `c1_2`。）您可以通过 `SHOW INDEX` 语句查看表上的索引。
ROW_FORMAT	指定表是否开启 Encoding 存储格式。 `redundant`：不开启 Encoding 存储格式。 `compact`：不开启 Encoding 存储格式。 `dynamic`：Encoding 存储格式。 `compressed`：Encoding 存储格式。 `condensed`：selective encoding (encoding 的子集，只使用查询更友好的编码方式)。 `default`：等价 `dynamic` 模式。
[GENERATED ALWAYS] AS (expr) [VIRTUAL \| STORED]	创建生成列，`expr` 为用于计算列值的表达式。 `VIRTUAL`：列值不会被存储，而是在读取行时，在任何 `BEFORE` 触发器之后立即计算。虚拟列不占用存储空间。 `STORED`：在插入或更新行时评估和存储列值。存储列确实需要存储空间并且可以被索引。
BLOCK_SIZE	指定表的微块大小。
COMPRESSION	指定表的压缩算法，取值如下： `none`：不使用压缩算法。 `lz4_1.0`: 使用 `lz4` 压缩算法。 `zstd_1.0`: 使用 `zstd` 压缩算法。 `snappy_1.0`: 使用 `snappy` 压缩算法。
CHARSET \| CHARACTER SET	指定表中列的默认字符集，可使用字符集如下： `utf8` `utf8mb4` `gbk` `utf16` `gb18030`
COLLATE	指定表中列的默认字符序，可使用字符序如下： `utf8_bin` `utf8_general_ci` `utf8_unicode_ci` `gbk_bin` `gbk_chinese_ci` `utf8mb4_general_ci` `utf8mb4__general_cs` `utf8mb4_bin` `utf8mb4_unicode_ci` `utf16_general_ci` `utf16_bin` `utf16_unicode_ci` `gb18030_chinese_ci` `gb18030_bin`
table_tablegroup	指定表所属的 `tablegroup`。
AUTO_INCREMENT	指定表中自增列的初始值。 OceanBase 数据库支持使用自增列作为分区键。
comment	注释。
LOCALITY	描述副本在 Zone 间的分布情况，如：`F@z1`、`F@z2` 、`F@z3`表示 `z1` 、`z2` 、`z3` 为全功能副本。
PCTFREE	指定宏块保留空间百分比。
parallel_clause	指定表级别的并行度： `NOPARALLEL`：并行度为 `1`，默认配置 `PARALLEL integer`：指定并行度，`integer` 取值大于等于 `1`。
CHECK	限制列中的值的范围。如果对单个列定义 `CHECK` 约束，那么该列级约束可以写到列定义中，并且可以指定名称。如果对一个表定义 `CHECK` 约束，那么此约束会应用于表中多个列，且允许出现在列的定义前。在删除表时，表中创建的 `CHECK` 约束也会一起被删除。可以通过如下方式查看约束信息：使用 `SHOW CREATE TABLE` 命令查看 `information_schema.TABLE_CONSTRAINTS` 视图查看 `information_schema.CHECK_CONSTRAINTS` 视图
constraint_name	约束名称，最多包含 64 个字符。约束名称的开头结尾中间都允许有空格，但需要用"`"标识名称的开头和结尾。约束名称可以包含特殊字符"$"。如果约束名称为保留字，需要用"`"标识，否则会报错。在同一 Database 下不允许 `CHECK` 约束的名称重复。
expression	约束表达式。 `expression` 不允许为空。 `expression` 结果不能为非布尔类型。 `expression` 不能包含不存在的列。

示例

创建带索引的表。

obclient> CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 INT, c3 INT, INDEX i1 (c2));
Query OK, 0 rows affected

创建 Hash 分区，分区数为 8 的表。

obclient> CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 INT) PARTITION BY HASH(c1) PARTITIONS 8;
Query OK, 0 rows affected

创建一级分区为 Range 分区，二级分区为 Key 分区的表。

obclient> CREATE TABLE t1 (c1 INT, c2 INT, c3 INT) PARTITION BY RANGE(c1) 
     SUBPARTITION BY KEY(c2, c3) SUBPARTITIONS 5
     (PARTITION p0 VALUES LESS THAN(0), PARTITION p1 VALUES LESS THAN(100));
Query OK, 0 rows affected

创建一列为 gbk, 一列为 utf8 的表。

obclient> CREATE TABLE t1 (c1 VARCHAR(10),
                 c2 VARCHAR(10) CHARSET GBK COLLATE gbk_bin)
             DEFAULT CHARSET utf8 COLLATE utf8mb4_general_ci;
Query OK, 0 rows affected

开启 Encoding 并使用 zstd 压缩，宏块保留空间为 5% 。

obclient> CREATE TABLE t1 (c1 INT, c2 INT, c3 VARCHAR(64))
      COMPRESSION 'zstd_1.0'
      ROW_FORMAT DYNAMIC
      PCTFREE 5;
Query OK, 0 rows affected

创建表 t1，并设置并行度为 3 。

obclient> CREATE TABLE tbl1(c1 INT PRIMARY KEY, c2 INT) PARALLEL 3;
Query OK, 0 rows affected

使用自增列作为分区键。

obclient> CREATE TABLE tbl2(inv_id BIGINT NOT NULL AUTO_INCREMENT,c1 BIGINT, 
PRIMARY KEY (inv_id) ) PARTITION BY HASH(inv_id) PARTITIONS 8;
Query OK, 0 rows affected

创建带 CHECK 约束的表 tbl5，并查看约束信息。

obclient> CREATE TABLE tbl5 (col1 INT, col2 INT, col3 INT, CONSTRAINT equal_check1 CHECK(col1 = col3 * 2));
Query OK, 0 rows affected

obclient> SHOW CREATE TABLE tbl5;
+-------+---------------------------------------------------------+
| Table | Create Table                                            |
+-------+---------------------------------------------------------+
| tbl5  | CREATE TABLE `tbl5` (
  `col1` int(11) DEFAULT NULL,
  `col2` int(11) DEFAULT NULL,
  `col3` int(11) DEFAULT NULL,
  CONSTRAINT `equal_check1` CHECK ((`col1` = (`col3` * 2)))
) DEFAULT CHARSET = utf8mb4 ROW_FORMAT = DYNAMIC COMPRESSION = 'zstd_1.3.8' REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0 |
+-------+----------------------------------------------------------+
1 row in set

依照表 tbl5 创建表 tbl6，并查看表信息。

obclient> CREATE TABLE tbl6 LIKE tbl5;
Query OK, 0 rows affected

obclient> SHOW CREATE TABLE tbl6;
+-------+---------------------------------------------------------+
| Table | Create Table                                         |
+-------+---------------------------------------------------------+
| tbl6  | CREATE TABLE `tbl6` (
  `col1` int(11) DEFAULT NULL,
  `col2` int(11) DEFAULT NULL,
  `col3` int(11) DEFAULT NULL,
  CONSTRAINT `tbl6_OBCHECK_1650793233327894` CHECK ((`col1` = (`col3` * 2)))
) DEFAULT CHARSET = utf8mb4 ROW_FORMAT = DYNAMIC COMPRESSION = 'zstd_1.3.8' REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0 |
+-------+----------------------------------------------------------+
1 row in set