--- title: "CREATE TABLE - OceanBase 数据库 V4.1.0 | OceanBase 文档中心" description: "CREATE TABLE 描述 该语句用来在数据库中创建一张新表。 语法 CREATE TABLE [IF NOT EXISTS] table_name (table_definition_list) [table_option_list] [partition_option] [AS] select; CREATE…" --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0 # CREATE TABLE 更新时间：2025-01-06 14:40:43 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/400.development-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/600.sql-statement-of-mysql-mode/2600.create-table-of-mysql-mode.md) ## 描述 该语句用来在数据库中创建一张新表。 ## 语法 ```sql 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] | [SPATIAL] {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 | TABLEGROUP = tablegroup_name | block_size | compression | AUTO_INCREMENT [=] INT_VALUE | comment | ROW_FORMAT [=] REDUNDANT|COMPACT|DYNAMIC|COMPRESSED|DEFAULT | PCTFREE [=] num | parallel_clause | READ {ONLY | WRITE} 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` 语句为表添加主键，参见[ALTER TABLE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001702339)。 | | FOREIGN KEY | 为创建的表指定外键。如果不指定外键名，则会使用表名 + `OBFK` + 创建时间命名。（例如，在 2021 年 8 月 1 日 00:00:00 为 `t1` 表创建的外键名称为 `t1_OBFK_1627747200000000`）。 | | KEY \| INDEX | 为创建的表指定键或索引。 如果不指定索引名，则会使用索引引用的第一列作为索引名，如果命名存在重复，则会使用下划线（_）+ 序号的方式命名。（例如，使用 `c1` 列创建的索引如果命名重复，则会将索引命名为 `c1_2`。） 您可以通过 `SHOW INDEX` 语句查看表上的索引。 | | SPATIAL | 指定为空间索引。 | | ROW_FORMAT | 指定表是否开启 Encoding 存储格式。 - `redundant`：不开启 Encoding 存储格式。 - `compact`：不开启 Encoding 存储格式。 - `dynamic`：Encoding 存储格式。 - `compressed`：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 | 指定表中列的默认字符集，可使用的字符集请参见 [字符集](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001702724)。 | | COLLATE | 指定表中列的默认字符序，可使用的字符序请参见 [字符序](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001702725)。 | | tablegroup_name | 指定表所属的 Table Group。 | | AUTO_INCREMENT | 指定表中自增列的初始值。OceanBase 数据库支持使用自增列作为分区键。 | | comment | 注释。 | | PCTFREE | 指定宏块保留空间百分比。 | | parallel_clause | 指定表级别的并行度： - `NOPARALLEL`：并行度为 `1`，默认配置 - `PARALLEL integer`：指定并行度，`integer` 取值大于等于 `1`。 | | READ {ONLY \| WRITE} | 指定表的读写权限。具体如下： - `READ ONLY`：表示表只能被读取，不能被修改或删除。 #### 注意 表级别的 `READ ONLY` 参数对具有 `SUPER` 权限的用户不生效，只对普通用户生效。 - `READ WRITE`：默认值，表示表可以被读取、修改和删除。 | | CHECK | 限制列中的值的范围。 - 如果对单个列定义 `CHECK` 约束，那么该列级约束可以写到列定义中，并且可以指定名称。 - 如果对一个表定义 `CHECK` 约束，那么此约束会应用于表中多个列，且允许出现在列的定义前。在删除表时，表中创建的 `CHECK` 约束也会一起被删除。 可以通过如下方式查看约束信息： - 使用 `SHOW CREATE TABLE` 命令 - 查看 `information_schema.TABLE_CONSTRAINTS` 视图 - 查看 `information_schema.CHECK_CONSTRAINTS` 视图 | | constraint_name | 约束名称，最多包含 64 个字符。 - 约束名称的开头结尾中间都允许有空格，但需要用"`"标识名称的开头和结尾。 - 约束名称可以包含特殊字符"$"。 - 如果约束名称为保留字，需要用"`"标识，否则会报错。 - 在同一 Database 下不允许 `CHECK` 约束的名称重复。 | | expression | 约束表达式。 - `expression` 不允许为空。 - `expression` 结果不能为非布尔类型。 - `expression` 不能包含不存在的列。 | ## 示例 - 创建数据库表。 ```sql obclient> CREATE TABLE test (c1 INT PRIMARY KEY, c2 VARCHAR(50)); Query OK, 0 rows affected ``` - 创建带索引的表。 ```sql obclient> CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 INT, c3 INT, INDEX i1 (c2)); Query OK, 0 rows affected ``` - 创建 Hash 分区，分区数为 `8` 的表。 ```sql obclient> CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 INT) PARTITION BY HASH(c1) PARTITIONS 8; Query OK, 0 rows affected ``` - 创建一级分区为 Range 分区，二级分区为 Key 分区的表。 ```sql 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` 的表。 ```sql 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%` 。 ```sql 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` 。 ```sql obclient> CREATE TABLE tbl1(c1 INT PRIMARY KEY, c2 INT) PARALLEL 3; Query OK, 0 rows affected ``` - 使用自增列作为分区键。 ```sql 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`，并查看约束信息。 ```sql 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`，并查看表信息。 ```sql 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 ``` - 在创建表 `t1_g` 时，同时添加空间索引 `t1_g_idx1`。 ```shell obclient> CREATE TABLE t1_g(id INT,name VARCHAR(18),g GEOMETRY NOT NULL SRID 4326,SPATIAL INDEX t1_g_idx1(g)); Query OK, 0 rows affected obclient> SHOW INDEX FROM t1_g; +-------+------------+-----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+-----------+---------------+---------+------------+ | Table | Non_unique | Key_name | Seq_in_index | Column_name | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression | +-------+------------+-----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+-----------+---------------+---------+------------+ | t1_g | 1 | t1_g_idx1 | 1 | g | A | NULL | NULL | NULL | | SPATIAL | available | | YES | NULL | +-------+------------+-----------+--------------+-------------+-----------+-------------+----------+--------+------+------------+-----------+---------------+---------+------------+ 1 row in set ``` 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线