描述

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

格式

  1. CREATE [TEMPORARY] TABLE [IF NOT EXISTS] table_name
  2.       (table_definition_list) [table_option_list] [partition_option] [AS] select;
  4. CREATE [TEMPORARY] TABLE [IF NOT EXISTS] table_name
  5.       LIKE table_name;
  7. table_definition_list:
  8.     table_definition [, table_definition ...]
  10. table_definition:
  11.       column_definition
  12.     | [CONSTRAINT [constraint_name]] PRIMARY KEY index_desc
  13.     | [CONSTRAINT [constraint_name]] UNIQUE {INDEX | KEY} [index_name] index_desc
  14.     | {INDEX | KEY} [index_name] index_desc
  15.     | FULLTEXT [INDEX | KEY] [index_name] fulltext_index_desc
  17. column_definition_list:
  18.     column_definition [, column_definition ...]
  20. column_definition:
  21.     column_name data_type
  22.     [DEFAULT const_value] [AUTO_INCREMENT]
  23.     [NULL | NOT NULL] [[PRIMARY] KEY] [UNIQUE [KEY]] comment
  25. index_desc:
  26.    (column_desc_list) [index_type] [index_option_list]
  28. fulltext_index_desc:
  29.    (column_desc_list) CTXCAT(column_desc_list) [index_option_list]
  31. column_desc_list:
  32.     column_desc [, column_desc ...]
  34. column_desc:
  35.      column_name [(length)] [ASC | DESC]
  37. index_type:
  38.     USING BTREE
  40. index_option_list:
  41.     index_option [ index_option ...]
  43. index_option:
  44.       [GLOBAL | LOCAL]
  45.     | block_size
  46.     | compression
  47.     | STORING(column_name_list)
  48.     | comment
  50. table_option_list:
  51.     table_option [ table_option ...]
  53. table_option:
  54.       [DEFAULT] {CHARSET | CHARACTER SET} [=] charset_name
  55.     | [DEFAULT] COLLATE [=] collation_name
  56.     | primary_zone
  57.     | replica_num
  58.     | table_tablegroup
  59.     | block_size
  60.     | compression
  61.     | AUTO_INCREMENT [=] INT_VALUE
  62.     | comment
  63.     | DUPLICATE_SCOPE [=] "none|zone|region|cluster"
  64.     | LOCALITY [=] "locality description"
  65.     | ROW_FORMAT [=] REDUNDANT|COMPACT|DYNAMIC|COMPRESSED|DEFAULT
  66.     | PCTFREE [=] num
  68. partition_option:
  69.       PARTITION BY HASH(expression)
  70.       [subpartition_option] PARTITIONS partition_count
  71.     | PARTITION BY KEY([column_name_list])
  72.       [subpartition_option] PARTITIONS partition_count
  73.     | PARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
  74.       [subpartition_option] (range_partition_list)
  75.     | PARTITION BY LIST {(expression) | COLUMNS (column_name_list)}
  76.       [subpartition_option] PARTITIONS partition_count
  78. subpartition_option:
  79.       SUBPARTITION BY HASH(expression)
  80.       SUBPARTITIONS subpartition_count
  81.     | SUBPARTITION BY KEY(column_name_list)
  82.       SUBPARTITIONS subpartition_count
  83.     | SUBPARTITION BY RANGE {(expression) | COLUMNS (column_name_list)}
  84.       (range_subpartition_list)
  85.     | SUBPARTITION BY LIST(expression)
  87. range_partition_list:
  88.     range_partition [, range_partition ...]
  90. range_partition:
  91.     PARTITION partition_name
  92.     VALUES LESS THAN {(expression_list) | MAXVALUE}
  94. range_subpartition_list:
  95.     range_subpartition [, range_subpartition ...]
  97. range_subpartition:
  98.     SUBPARTITION subpartition_name
  99.     VALUES LESS THAN {(expression_list) | MAXVALUE}
  101. expression_list:
  102.     expression [, expression ...]
  104. column_name_list:
  105.     column_name [, column_name ...]
  107. partition_name_list:
  108.     partition_name [, partition_name ...]
  110. partition_count | subpartition_count:
  111.     INT_VALUE

参数说明

参数

描述

DUPLICATE_SCOPE

用来指定复制表属性，取值如下：

  • none：表示该表是一个普通表

  • zone：表示该表是一个复制表，leader需要将事务复制到本zone的所有F副本及R副本

  • region：表示该表是一个复制表，leader需要将事务复制到本region的所有F副本及R副本

  • cluster：表示该表是一个复制表，leader需要将事务复掉到cluster的所有F副本及R副本

不指定DUPLICATE_SCOPE的情况下，默认值为none。

ROW_FORMAT

指定表是否开启encoding存储格式

  • redundant

    • 不开启encoding存储格式

  • compact

    • 不开启encoding存储格式

  • dynamic

    • encoding存储格式

  • compressed

    • encoding存储格式

  • default

    • 等价dynamic模式

BLOCK_SIZE

指定表的微块大小

COMPRESSION

指定表的压缩算法，取值如下：

  1. none：不使用压缩算法

  2. lz4_1.0: 使用lz4压缩算法

  3. zstd_1.0: 使用zstd压缩算法

  4. 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

primary_zone

指定主Zone（副本Leader所在 Zone）。

replica_num

指定副本数。

table_tablegroup

指定表所属的talegroup。

AUTO_INCREMENT

指定表中自增列的初始值。

comment

注释。

LOCALITY

描述副本在Zone间的分布情况，如：F@z1,F@z2,F@z3,R@z4 表示z1, z2, z3为全功能副本，z4为只读副本。

PCTFREE

指定宏块保留空间百分比。

举例

  • 创建数据库表。
  1. CREATE TABLE test (c1 int primary key, c2 VARCHAR(50)) REPLICA_NUM = 3, PRIMARY_ZONE = 'zone1';
  • 创建一个复制表。
  1. CREATE TABLE item(id int, name varchar(10)) DUPLICATE_SCOPE="cluster";
  • 创建带索引的表。
  1. CREATE TABLE t1 (c1 int primary key, c2 int, c3 int, index i1 (c2));
  • 创建 hash 分区，分区数为 8 的表。
  1. CREATE TABLE t1 (c1 int primary key, c2 int) partition by hash(c1) partitions 8;
  • 创建一级分区为 range 分区，二级分区为 key 分区的表。
  1.  CREATE TABLE t1 (c1 int, c2 int, c3 int)
  2.      partition by range(c1) subpartition by key(c2, c3) subpartitions 5
  3.      (partition p0 values less than(0), partition p1 values less than(100));
  • 创建一列为 gbk, 一列为 utf8 的表。
  1. CREATE TABLE t1 (c1 varchar(10),
  2.                  c2 varchar(10) charset gbk collate gbk_bin)
  3.   default charset utf8 collate utf8mb4_general_ci;
  • 开启 encoding 并使用 zstd 压缩，宏块保留空间为 5%。
  1. CREATE TABLE t1 (c1 int, c2 int, c3 varchar(64))
  2.   compression 'zstd_1.0'
  3.   ROW_FORMAT dynamic
  4.   pctfree 5;