enum -> PartitionByFileMap

根据用户定义的枚举值与分片节点映射文件，直接定位目标分片。

PartitionByFileMap工作示意图

1. 用户在rule.xml中配置枚举值文件路径和分片索引是字符串还是数字，DBLE在启动时会将枚举值文件加载到内存中，形成一个映射表
2. 在DBLE的运行过程中，用户访问使用这个算法的表时，WHERE子句中的分片索引值会被提取出来，直接查映射表得到分片编号

• 开发注意点

  • 【分片索引】1，整型数字（可以为负数）或字符串（（不含=和换行符）
  • 【分片索引】2，枚举值之间不能重复，“Male=0<换行>Male=1”或者“123=1<换行>123=2”会导致分片策略加载出错
  • 【分片索引】3，不同枚举值可以映射到同一个分片上，“Mr.=0<换行>Mrs.=1<换行>Miss=1<换行>Ms.=1”或者“123=0<换行>”

• 运维注意点

  • 【扩容】1，增加枚举值无需数据再平衡
  • 【扩容】2，增加一个枚举值的分片数量数时，需要对局部数据进行迁移
  • 【缩容】1，减少枚举值需要数据再平衡
  • 【缩容】2，减少一个枚举值的分片数量数时，需要对局部数据进行迁移

• 配置注意点

  • 【配置项】1，在rule.xml中，可配置项为<property name="defaultNode">、<property name="mapFile">和<property name="type">
  • 【配置项】2，在rule.xml中配置<property name="defaultNode">标签，非必须配置项，不配置该项的话，用户的分片索引值没落在mapFile定义的范围时，DBLE会报错；若需要配置，必须为非负整数，用户的分片索引值没落在mapFile定义的范围时，DBLE会路由至这个值的MySQL分片
  • 【配置项】3，在rule.xml中配置<property name="mapFile">标签，范围映射文件的路径：若在映射文件在DBLE_HOME/conf或其中，则可以使用相对路径的形式配置，例如，映射文件是DBLE_HOME/conf/map/table_map.txt时，配置值就可以简写为map/table_map.txt；映射文件在DBLE_HOME/conf目录以外时，需要使用绝对路径，但这种做法需要考虑用户权限等问题，因此不建议把映射文件放在DBLE_HOME/conf外。
  • 【配置项】4，编辑mapFile所配置的文件，记录格式为“<枚举值>=<分片编号>”，<枚举值>可以是整型数字，或任意字符（除了=和换行符），<分片编号>必须是非负整型数字，记录之间以换行分隔，一行仅能有一条记录，<枚举值>不能够是“DEFAULT_NODE”这个字符串，允许以“//”和“#”在行首来注释该行
  • 【配置项】5，在rule.xml中配置<property name="type">标签；type必须为整型；取值为0时，mapFile的<枚举值>必须为整型；取值为非0时，mapFile的<枚举值>可以是任意字符（除了=和换行符）