CREATE TABLE（AUTO模式）1

注意事项

• 使用分区表语法之前，请务必确认创建当前的逻辑库时模式指定为自动分区模式（mode='auto' ），非自动分区模式不允许使用分区表的建表语法。您也可以通过SHOW CREATE DATBASE db_name语法查看当前逻辑库的建表模式。示例如下：

  
  

  CREATE DATABASE part_db mode='auto';
  Query OK, 1 row affected (4.29 sec)
  
  SHOW CREATE DATABASE part_db;
  +----------+-----------------------------------------------+
  | DATABASE | CREATE DATABASE                               |
  +----------+-----------------------------------------------+
  | part_db  | CREATE DATABASE `part_db` /* MODE = 'auto' */ |
  +----------+-----------------------------------------------+
  1 row in set (0.18 sec)

  创建数据库的语法详情，请参见CREATE DATABASE。

• 如果分区表的主键不含分区键， 且不是自增主键，需要业务保证主键的唯一性。

语法

CREATE [PARTITION] TABLE [IF NOT EXISTS] tbl_name
    (create_definition, ...)
    [table_options]
    [table_partition_definition]
    [local_partition_definition]

create_definition:
    col_name column_definition
  | mysql_create_definition
  | [UNIQUE] GLOBAL INDEX index_name [index_type] (index_sharding_col_name,...)
      [global_secondary_index_option]
      [index_option] ...

index_sharding_col_name:
    col_name [(length)] [ASC | DESC]

index_option:
    KEY_BLOCK_SIZE [=] value
  | index_type
  | WITH PARSER parser_name
  | COMMENT 'string'

index_type:
    USING {BTREE | HASH}

# 全局二级索引相关
global_secondary_index_option:
    [COVERING (col_name,...)]
    [partition_options]
    [VISIBLE|INVISIBLE]

table_options:
    table_option [[,] table_option] ...

table_option: {
# 指定tablegroup
    TABLEGROUP [=] value,...,}

# 分区表类型定义
table_partition_definition:
        single
  |    broadcast
  | partition_options


# 分区策略定义
partition_options:
    PARTITION BY
          HASH({column_name | partition_func(column_name)})
        | KEY(column_list)
        | RANGE{({column_name | partition_func(column_name)})
        | RANGE COLUMNS(column_list)}
        | LIST{({column_name | partition_func(column_name)})
        | LIST COLUMNS(column_list)} }
    partition_list_spec

# 分区函数定义
partition_func：
    YEAR
  | TO_DAYS
  | TO_MONTHS
  | TO_WEEKS
  | TO_SECOND
  | UNIX_TIMESTAMP
  | MONTH
  | DAYOFWEEK
  | DAYOFMONTH
  | DAYOFYEAR
  | SUBSTR
  | SUBSTRING

# 三种分区类型定义
partition_list_spec:
        hash_partition_list
  | range_partition_list
  | list_partition_list

# Hash/Key分区定义
hash_partition_list:
    PARTITIONS partition_count

# Range/Range Columns分区定义
range_partition_list:
    range_partition [, range_partition ...]

range_partition:
    PARTITION partition_name VALUES LESS THAN {(expr | value_list)} [partition_spec_options]

# List/List Columns分区定义
list_partition_list:
    list_partition [, list_partition ...]

list_partition:
    PARTITION partition_name VALUES IN (value_list) [partition_spec_options]

partition_spec_options:
          [[STORAGE] ENGINE [=] engine_name]
        [COMMENT [=] 'string']
        [LOCALITY [=] locality_option]

table_option：
           [[STORAGE] ENGINE [=] engine_name]
        [COMMENT [=] 'string']
        [{CHARSET | CHARACTER SET} [=] charset]
        [COLLATE [=] collation]
        [TABLEGROUP [=] table_group_id]
        [LOCALITY [=] locality_option]

locality_option:
    'dn=storage_inst_id_list'

storage_inst_id_list:
    storage_inst_id[,storage_inst_id_list]

local_partition_definition:
        LOCAL PARTITION BY RANGE (column_name)
    [STARTWITH 'yyyy-MM-dd']
    INTERVAL interval_count [YEAR|MONTH|DAY]
    [EXPIRE AFTER expire_after_count]
    [PRE ALLOCATE pre_allocate_count]
    [PIVOTDATE pivotdate_func]
    [DISABLE SCHEDULE]

pivotdate_func:
        NOW()
  |    DATE_ADD(...)
  | DATE_SUB(...)

说明

PolarDB-X DDL语法基于MySQL语法，以上主要列出了差异部分，详细语法请参见MySQL 文档。

名词解释

• 分区键：分区表中用于进行水平切分的一个列或多个列。
• 分区列：水平切分后，参与分区路由及计算的列，它通常是分区键的一部分，一个分区键可以含有一个或多个分区列。
• 向量分区键：由一个或多个分区列组成的分区键。
• 单列分区键：由一个分区列组成的分区键。
• 前缀分区列：若一个向量分区键由N（N>1）个分区列组成，它的前K（1<=K<=N）个分区列便组成这个向量分区键的前缀分区列。
• 分区函数：将分区列作为一个函数的输入参数，并将该函数的输出结果作为原始值参与路由计算，该函数被称为分区函数。
• 分区裁剪：根据分区定义及查询条件，最大限度地过滤不需要扫描的分区的查询优化手段。
• 热点分裂：当向量分区键的前缀分区列存在访问热点或分布不均衡时，允许使用下一个分区列对热点分区进行分裂，以达到负载均衡效果。

参数说明