分区支持与限制¶
支持范围¶
启用分区功能的实例支持使用 KEY、HASH、RANGE、RANGE COLUMNS、LIST 和 LIST COLUMNS 创建分区表。RANGE 和 LIST 分区会检查写入数据；没有匹配分区时，插入失败。
RANGE：使用VALUES LESS THAN定义分区上界，上界不包含在该分区内。如果需要接收大于或等于最后一个有限上界的值，可将最后一个分区定义为VALUES LESS THAN (MAXVALUE)。LIST：使用VALUES IN指定各分区接收的值；未匹配任何分区的值无法插入。不支持子分区，也不支持在分区表上定义外键。
分区能力可能随实例版本和配置变化。使用前应在目标实例上验证建表、正常写入和越界写入行为。查看分区定义的方法见系统表。
MatrixOne 4.2.5 的 RANGE COLUMNS 和 LIST COLUMNS 使用单列分区键。以下示例使用单列；其他版本的列数与类型限制应按实例能力确认。
2. 关于分区键的说明¶
Partition Keys, Primary Keys 和 Unique Keys 的关系¶
分区键（Partition Keys）、主键（Primary Keys）和唯一键（Unique Keys）的关系规则可以概括为：
分区表的分区表达式中使用的所有列必须是该表可能具有的每个唯一键的一部分。
备注
唯一键包括 PrimaryKey 和 Unique KEY。
也就是说，表上的每个唯一键必须使用表的分区表达式中的每一列。唯一键也包括表的主键，因为根据定义，表的主键也是唯一键。
示例说明¶
例如，以下每个表创建语句都无效：
CREATE TABLE t1 (
col1 INT NOT NULL,
col2 DATE NOT NULL,
col3 INT NOT NULL,
col4 INT NOT NULL,
UNIQUE KEY (col1, col2)
)
PARTITION BY HASH(col3)
PARTITIONS 4;
ERROR 1503 (HY000): A PRIMARY KEY must include all columns in the table's partitioning function
CREATE TABLE t2 (
col1 INT NOT NULL,
col2 DATE NOT NULL,
col3 INT NOT NULL,
col4 INT NOT NULL,
UNIQUE KEY (col1),
UNIQUE KEY (col3)
)
PARTITION BY HASH(col1 + col3)
PARTITIONS 4;
ERROR 1503 (HY000): A PRIMARY KEY must include all columns in the table's partitioning function
关于 KEY 分区键为 NULL¶
KEY 只接受零个或多个列名的列表。在表有主键的情况下，用作分区键的任何列必须包含表主键的一部分或全部。
如果没有指定列名作为分区键，则使用表的主键（如果有）。例如，以下
CREATE TABLE语句在 MySQL 中有效。如果没有主键，但有 UNIQUE KEY，那么 UNIQUE KEY 用于分区键。
例如，以下建表语句中，KEY 分区分区键为 NULL，没有定义主键，但是含有唯一键，构建分区表达式时则使用唯一键作为分区键：
CREATE TABLE t1 (
col1 INT NOT NULL,
col2 DATE NOT NULL,
col3 INT NOT NULL,
col4 INT NOT NULL,
UNIQUE KEY (col1, col2)
)
PARTITION BY KEY()
PARTITIONS 4;
备注
分区语法和限制以实例使用的 MatrixOne 引擎版本为准。
3. 关于 MatrixOne 分区表达式的说明¶
在 DDL 语句构建分区表时，会针对每一种分区定义生成一个分区表达式，该分区表达式可用于计算数据的所属的分区。
在计划构建阶段对 DDL 语句中的分区信息数据结构为 plan.PartitionInfo：
type PartitionInfo struct {
Type PartitionType
Expr *Expr
PartitionExpression *Expr
Columns []*Expr
PartitionColumns []string
PartitionNum uint64
Partitions []*PartitionItem
Algorithm int64
IsSubPartition bool
PartitionMsg string
}
其中 PartitionExpression 即为分区表达式。分区表达式为 MatrixOne 把分区子句转换为一个表达式进行处理的方式，对每一种分区表达式的构建方式如下：
KEY Partitioning¶
KEY 分区会根据分区键和分区数量，构建一个分区表达式，分区表达式的计算结果为一个大于等于 0 的整数，代表分区序号，从零开始依次递增。
SQL 示例如下：
CREATE TABLE t1 (
col1 INT NOT NULL,
col2 DATE NOT NULL,
col3 INT NOT NULL,
col4 INT NOT NULL,
PRIMARY KEY (col1, col2)
)
PARTITION BY KEY(col1)
PARTITIONS 4;
HASH Partitioning¶
与 KEY 分区类似，HASH 分区会根据分区函数和分区数量，构建一个分区表达式，分区表达式的计算结果为一个大于等于 0 的整数，代表分区序号，从零开始依次递增。
SQL 示例如下：
CREATE TABLE t1 (
col1 INT,
col2 CHAR(5),
col3 DATE
)
PARTITION BY LINEAR HASH( YEAR(col3))
PARTITIONS 6;
RANGE Partitioning¶
RANGE 分区是基于列值的范围将表的数据划分到不同的分区中的一种方法。这种分区类型非常适合于那些可以根据特定列的值范围进行分段的数据。
SQL 示例如下：
CREATE TABLE employees (
id INT NOT NULL,
fname VARCHAR(30),
lname VARCHAR(30),
hired DATE NOT NULL DEFAULT '1970-01-01',
separated DATE NOT NULL DEFAULT '9999-12-31',
job_code INT NOT NULL,
store_id INT NOT NULL
)
PARTITION BY RANGE (store_id) (
PARTITION p0 VALUES LESS THAN (6),
PARTITION p1 VALUES LESS THAN (11),
PARTITION p2 VALUES LESS THAN (16),
PARTITION p3 VALUES LESS THAN MAXVALUE
);
RANGE COLUMNS¶
RANGE COLUMNS 按列值的范围选择分区。各上界使用 VALUES LESS THAN，末尾可用 MAXVALUE 接收剩余值。
CREATE TABLE rc (a INT NOT NULL, b INT)
PARTITION BY RANGE COLUMNS(a) (
PARTITION p0 VALUES LESS THAN (10),
PARTITION p1 VALUES LESS THAN (20),
PARTITION pmax VALUES LESS THAN (MAXVALUE)
);
LIST Partitioning¶
LIST 分区是基于单个列的离散值来划分数据，每个分区包含了列值的一个特定列表，当插入数据时，行根据该列的值被分配到相应的分区。
SQL 示例如下：
CREATE TABLE client_firms (
id INT,
name VARCHAR(35)
)
PARTITION BY LIST (id) (
PARTITION r0 VALUES IN (1, 5, 9, 13, 17, 21),
PARTITION r1 VALUES IN (2, 6, 10, 14, 18, 22),
PARTITION r2 VALUES IN (3, 7, 11, 15, 19, 23),
PARTITION r3 VALUES IN (4, 8, 12, 16, 20, 24)
);
LIST COLUMNS¶
LIST COLUMNS 按列值的枚举列表选择分区。VALUES IN 列出各分区接收的值；没有匹配分区的值无法插入。
CREATE TABLE lc (a INT, b INT)
PARTITION BY LIST COLUMNS(a) (
PARTITION p0 VALUES IN (1, 2),
PARTITION p1 VALUES IN (3, 4)
);