date -> AutoPartitionByDate

以每24小时作为一份时间（而非自然日），根据用户的配置有两种工作模式：带状模式中，用户仅定义开始日期时，从开始日期（含）开始，每份时间1个分片地无限增加下去；环状模式中，用户定义了开始日期和结束日期时，以结束日期（含）和开始日期（含）之间的时间份数作为分片总数（分片数量固定），以类似取模的方式路由到这些分片里。

PartitionByDate带状模式工作示意图

1. DBLE启动时，读取用户在rule.xml配置的sBeginDate来确定起始时间
2. 读取用户在rule.xml配置的sPartionDay来确定每个MySQL分片承载多少天内的数据
3. 读取用户在rule.xml配置的dateFormat来确定分片索引的日期格式
4. 在DBLE的运行过程中，用户访问使用这个算法的表时，WHERE子句中的分片索引值（字符串），会被提取出来尝试转换成Java内部的时间类型
5. 然后求分片索引值与起始时间的差，除以MySQL分片承载的天数，确定所属分片

PartitionByDate环状模式工作示意图

1. DBLE启动时，读取用户在rule.xml配置的起始时间sBeginDate、终止时间sEndDate和每个MySQL分片承载多少天数据sPartionDay
2. 根据用户设置，建立起以sBeginDate开始，每sPartionDay天一个分片，直到sEndDate为止的一个环，把分片串联串联起来
3. 读取用户在rule.xml配置的defaultNode
4. 在DBLE的运行过程中，用户访问使用这个算法的表时，WHERE子句中的分片索引值（字符串），会被提取出来尝试转换成Java内部的日期类型
5. 然后求分片索引值与起始日期的差：如果分片索引值不早于sBeginDate（哪怕晚于sEndDate），就以MySQL分片承载的天数为模数，对分片索引值求模得到所属分片；如果分片索引值早于sBeginDate，就会被放到defaultNode分片上

• 开发注意点

  • 【分片索引】1，必须是字符串，而且java.text.SimpleDateFormat能基于用户指定的dateFormat来转换成java.util.Date
  • 【分片索引】2，提供带状模式和环状模式两种模式
  • 【分片索引】3，带状模式以sBeginDate（含）起，以86400000毫秒（24小时整）为一份，每sPartionDay份为一个分片，理论上分片数量可以无限增长，但是出现sBeginDate之前的数据而且没有设定defaultNode的话，会路由失败（如果有defaultNode，则路由至defaultNode）
  • 【分片索引】4，环状模式以86400000毫秒（24小时整）为一份，每sPartionDay份为一个分片，以sBeginDate（含）到sEndDate（含）的时间长度除以单个分片长度得到恒定的分片数量，但是出现sBeginDate之前的数据而且没有设定defaultNode的话，会路由失败（如果有defaultNode，则路由至defaultNode）
  • 【分片索引】5，无论哪种模式，分片索引字段的格式化字符串dateFormat由用户指定
  • 【分片索引】6，无论哪种模式，划分不是以日历时间为准，无法对应自然月和自然年，且会受闰秒问题影响

• 运维注意点

  • 【扩容】1，带状模式中，随着sBeginDate之后的数据出现，分片数量的增加无需再平衡
  • 【扩容】2，带状模式没有自动增添分片的能力，需要运维手工提前增加分片；如果路由策略计算出的分片并不存在时，会导致失败
  • 【扩容】3，环状模式中，如果新旧[sBeginDate,sEndDate]之间有重叠，需要进行部分数据迁移；如果新旧[sBeginDate,sEndDate]之间没有重叠，需要数据再平衡

• 配置注意点

  • 【配置项】1，在rule.xml中，可配置项为<property name="sBeginDate">、<property name="sPartionDay">、<property name="dateFormat">、<property name="sEndDate">和<property name="defaultNode">
  • 【配置项】2，在rule.xml中配置<property name="dateFormat">，符合java.text.SimpleDateFormat规范的字符串，用于告知DBLE如何解析sBeginDate和sEndDate
  • 【配置项】3，在rule.xml中配置<property name="sBeginDate">，必须是符合dateFormat的日期字符串
  • 【配置项】4，在rule.xml中配置<property name="sEndDate">，必须是符合dateFormat的日期字符串；配置了该项使用的是环状模式，若没有配置该项则使用的是带状模式
  • 【配置项】5，在rule.xml中配置<property name="sPartionDay">，非负整数，该分片策略以86400000毫秒（24小时整）作为一份，而sPartionDay告诉DBLE把每多少份放在同一个分片
  • 【配置项】6，在rule.xml中配置<property name="defaultNode">标签，非必须配置项，不配置该项的话，用户的分片索引值没落在mapFile定义的范围时，DBLE会报错；若需要配置，必须为非负整数，用户的分片索引值没落在mapFile定义的范围时，DBLE会路由至这个值的MySQL分片