CREATE TABLE

CREATE TABLE 语句用于在当前所选数据库中创建新表,与 MySQL 中 CREATE TABLE 语句的行为类似。另可参阅单独的 CREATE TABLE LIKE 文档。

语法图

  1. CreateTableStmt ::=
  2. 'CREATE' OptTemporary 'TABLE' IfNotExists TableName ( TableElementListOpt CreateTableOptionListOpt PartitionOpt DuplicateOpt AsOpt CreateTableSelectOpt | LikeTableWithOrWithoutParen )
  3. IfNotExists ::=
  4. ('IF' 'NOT' 'EXISTS')?
  5. TableName ::=
  6. Identifier ('.' Identifier)?
  7. TableElementListOpt ::=
  8. ( '(' TableElementList ')' )?
  9. TableElementList ::=
  10. TableElement ( ',' TableElement )*
  11. TableElement ::=
  12. ColumnDef
  13. | Constraint
  14. ColumnDef ::=
  15. ColumnName ( Type | 'SERIAL' ) ColumnOptionListOpt
  16. ColumnOptionListOpt ::=
  17. ColumnOption*
  18. ColumnOptionList ::=
  19. ColumnOption*
  20. ColumnOption ::=
  21. 'NOT'? 'NULL'
  22. | 'AUTO_INCREMENT'
  23. | PrimaryOpt 'KEY'
  24. | 'UNIQUE' 'KEY'?
  25. | 'DEFAULT' DefaultValueExpr
  26. | 'SERIAL' 'DEFAULT' 'VALUE'
  27. | 'ON' 'UPDATE' NowSymOptionFraction
  28. | 'COMMENT' stringLit
  29. | ConstraintKeywordOpt 'CHECK' '(' Expression ')' EnforcedOrNotOrNotNullOpt
  30. | GeneratedAlways 'AS' '(' Expression ')' VirtualOrStored
  31. | ReferDef
  32. | 'COLLATE' CollationName
  33. | 'COLUMN_FORMAT' ColumnFormat
  34. | 'STORAGE' StorageMedia
  35. | 'AUTO_RANDOM' OptFieldLen
  36. CreateTableOptionListOpt ::=
  37. TableOptionList?
  38. PartitionOpt ::=
  39. ( 'PARTITION' 'BY' PartitionMethod PartitionNumOpt SubPartitionOpt PartitionDefinitionListOpt )?
  40. DuplicateOpt ::=
  41. ( 'IGNORE' | 'REPLACE' )?
  42. TableOptionList ::=
  43. TableOption ( ','? TableOption )*
  44. TableOption ::=
  45. PartDefOption
  46. | DefaultKwdOpt ( CharsetKw EqOpt CharsetName | 'COLLATE' EqOpt CollationName )
  47. | ( 'AUTO_INCREMENT' | 'AUTO_ID_CACHE' | 'AUTO_RANDOM_BASE' | 'AVG_ROW_LENGTH' | 'CHECKSUM' | 'TABLE_CHECKSUM' | 'KEY_BLOCK_SIZE' | 'DELAY_KEY_WRITE' | 'SHARD_ROW_ID_BITS' | 'PRE_SPLIT_REGIONS' ) EqOpt LengthNum
  48. | ( 'CONNECTION' | 'PASSWORD' | 'COMPRESSION' ) EqOpt stringLit
  49. | RowFormat
  50. | ( 'STATS_PERSISTENT' | 'PACK_KEYS' ) EqOpt StatsPersistentVal
  51. | ( 'STATS_AUTO_RECALC' | 'STATS_SAMPLE_PAGES' ) EqOpt ( LengthNum | 'DEFAULT' )
  52. | 'STORAGE' ( 'MEMORY' | 'DISK' )
  53. | 'SECONDARY_ENGINE' EqOpt ( 'NULL' | StringName )
  54. | 'UNION' EqOpt '(' TableNameListOpt ')'
  55. | 'ENCRYPTION' EqOpt EncryptionOpt

TiDB 支持以下 table_option。TiDB 会解析并忽略其他 table_option 参数,例如 AVG_ROW_LENGTHCHECKSUMCOMPRESSIONCONNECTIONDELAY_KEY_WRITEENGINEKEY_BLOCK_SIZEMAX_ROWSMIN_ROWSROW_FORMATSTATS_PERSISTENT

参数 含义 举例
AUTO_INCREMENT 自增字段初始值 AUTO_INCREMENT = 5
SHARD_ROW_ID_BITS 用来设置隐式 _tidb_rowid 的分片数量的 bit 位数 SHARD_ROW_ID_BITS = 4
PRE_SPLIT_REGIONS 用来在建表时预先均匀切分 2^(PRE_SPLIT_REGIONS) 个 Region PRE_SPLIT_REGIONS = 4
AUTO_ID_CACHE 用来指定 Auto ID 在 TiDB 实例中 Cache 的大小,默认情况下 TiDB 会根据 Auto ID 分配速度自动调整 AUTO_ID_CACHE = 200
AUTO_RANDOM_BASE 用来指定 AutoRandom 自增部分的初始值,该参数可以被认为属于内部接口的一部分,对于用户而言请忽略 AUTO_RANDOM_BASE = 0
CHARACTER SET 指定该表所使用的字符集 CHARACTER SET = ‘utf8mb4’
COLLATE 指定该表所使用的字符集排序规则 COLLATE = ‘utf8mb4_bin’
COMMENT 注释信息 COMMENT = ‘comment info’

注意:

在 TiDB 配置文件中,split-table 默认开启。当该配置项开启时,建表操作会为每个表建立单独的 Region,详情参见 TiDB 配置文件描述

示例

创建一张简单表并插入一行数据:

  1. CREATE TABLE t1 (a int);
  2. DESC t1;
  3. SHOW CREATE TABLE t1\G
  4. INSERT INTO t1 (a) VALUES (1);
  5. SELECT * FROM t1;
  1. mysql> drop table if exists t1;
  2. Query OK, 0 rows affected (0.23 sec)
  3. mysql> CREATE TABLE t1 (a int);
  4. Query OK, 0 rows affected (0.09 sec)
  5. mysql> DESC t1;
  6. +-------+---------+------+------+---------+-------+
  7. | Field | Type | Null | Key | Default | Extra |
  8. +-------+---------+------+------+---------+-------+
  9. | a | int(11) | YES | | NULL | |
  10. +-------+---------+------+------+---------+-------+
  11. 1 row in set (0.00 sec)
  12. mysql> SHOW CREATE TABLE t1\G
  13. *************************** 1. row ***************************
  14. Table: t1
  15. Create Table: CREATE TABLE `t1` (
  16. `a` int(11) DEFAULT NULL
  17. ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
  18. 1 row in set (0.00 sec)
  19. mysql> INSERT INTO t1 (a) VALUES (1);
  20. Query OK, 1 row affected (0.03 sec)
  21. mysql> SELECT * FROM t1;
  22. +------+
  23. | a |
  24. +------+
  25. | 1 |
  26. +------+
  27. 1 row in set (0.00 sec)

删除一张表。如果该表不存在,就建一张表:

  1. DROP TABLE IF EXISTS t1;
  2. CREATE TABLE IF NOT EXISTS t1 (
  3. id BIGINT NOT NULL PRIMARY KEY auto_increment,
  4. b VARCHAR(200) NOT NULL
  5. );
  6. DESC t1;
  1. mysql> DROP TABLE IF EXISTS t1;
  2. Query OK, 0 rows affected (0.22 sec)
  3. mysql> CREATE TABLE IF NOT EXISTS t1 (
  4. -> id BIGINT NOT NULL PRIMARY KEY auto_increment,
  5. -> b VARCHAR(200) NOT NULL
  6. -> );
  7. Query OK, 0 rows affected (0.08 sec)
  8. mysql> DESC t1;
  9. +-------+--------------+------+------+---------+----------------+
  10. | Field | Type | Null | Key | Default | Extra |
  11. +-------+--------------+------+------+---------+----------------+
  12. | id | bigint(20) | NO | PRI | NULL | auto_increment |
  13. | b | varchar(200) | NO | | NULL | |
  14. +-------+--------------+------+------+---------+----------------+
  15. 2 rows in set (0.00 sec)

MySQL 兼容性

  • TiDB 不支持临时表。如果 tidb_enable_noop_functions = 0 ,执行 CREATE TEMPORARY TABLE 语法会报错;如果 tidb_enable_noop_functions = 1,TiDB 会忽略 TEMPORARY 关键字。
  • 支持除空间类型以外的所有数据类型。
  • 不支持 FULLTEXTHASHSPATIAL 索引。
  • 为了与 MySQL 兼容,index_col_name 属性支持 length 选项,最大长度默认限制为 3072 字节。此长度限制可以通过配置项 max-index-length 更改,具体请参阅 TiDB 配置文件描述
  • 为了与 MySQL 兼容,TiDB 会解析但忽略 index_col_name 属性的 [ASC | DESC] 索引排序选项。
  • COMMENT 属性最多支持 1024 个字符,不支持 WITH PARSER 选项。
  • TiDB 在单个表中最多支持 512 列。InnoDB 中相应的数量限制为 1017,MySQL 中的硬限制为 4096。详情参阅 TiDB 使用限制
  • 当前仅支持 Range、Hash 和 Range Columns(单列)类型的分区表,详情参阅分区表
  • TiDB 会解析并忽略 CHECK 约束,与 MySQL 5.7 相兼容。详情参阅 CHECK 约束
  • TiDB 会解析并存储外键约束,但不会在 DML 语句中强制对外键进行约束检查。详情外键约束

另请参阅