3.20.07.0 版本 DBLE Release Notes

以下对 DBLE 3.20.07.0 版本的 Release Notes 进行详细解读。
文章主要分为以下三部分内容：
一、DBLE 项目介绍
二、新版本主要更新解读
三、完整 Release Notes 及翻译

https://github.com/actiontech/dble

一、DBLE 项目介绍

DBLE 是企业级开源分布式中间件，江湖人送外号 “MyCat Plus”；以其简单稳定，持续维护，良好的社区环境和广大的群众基础得到了社区的大力支持；

• DBLE 官方项目：
  https://github.com/actiontech/dble
• DBLE 官方文档（已更新）：
  https://actiontech.github.io/dble-docs-cn
• 新版本 DBLE 下载地址及 Release Notes：https://github.com/actiontech/dble/releases

官方课程：

• 点击学习《DBLE 快速上手》，实操视频 + 图文稿！
• 点击学习《DBLE 公开课》进阶课程

Tips：建议下载最新的 Releases 版本，下载 tar 压缩包即可，如有源码编译需求的，可以下载源码包。

二、新版本主要更新解读

DBLE 3.20.07.0 已于今日发布，这是今年 DBLE 第三次发版，感慨上一次还是在 5 月 19 日。相信接下来的发版频率会逐渐恢复正常。

新版 DBLE 新增重构功能 6 个，修复缺陷 16 个，向后兼容性调整 1 处；

致谢：

• 首先，我们必须感谢以下人士对我们社区的贡献：@dairight, @z3093964447
• 感谢 Github 用户提供的优质 issue，star 接近 700！
• 感谢 QQ 群（669663113）内朋友提供的有效反馈，群用户数突破千人！

主要更新：

1、配置文件重构！！！

可以通过升级工具 dble_update_config 将配置从 2.20.04.0 升级到 3.20.07.0，如果是更早版本，建议先升级到 2.20.04.0。

升级工具用法：

dble_update_config [-i=read_dir] [-o=write_dir] [-p=rootPath]

read_dir/write_dir：如果不指定，缺省值为当前目录，建议指定或者提前备份配置 rootPath：如果集群模式是 zk，那么缺省值为 /dble，如果集群模式是 ucore，缺省值为 universe/dble。

工具将会读取文件：

• myid.properties
• wrapper.conf
• server.xml
• schema.xml
• rule.xml
• log4j2.xml
• cacheservice.properties(option)
• sequence_distributed_conf.properties for type3 (option)
• sequence_time_conf.properties for type2 (option)

然后写出文件：

• cluster.cnf
• bootstrap.cnf
• user.xml
• db.xml
• sharding.xml
• log4j2.xml
• cacheservice.properties(option)

（建议在 PC 端浏览细节）

2、非拆分表的复杂的 DML 语句支持

非拆分表的以下四种 DML 语句支持直接下推到 MySQL：

INSERT ... SELECT

DELETE... 多表关联

UPDATE... 多表关联

另外，拆分规则相同的表格也会支持 INSERT ... SELECT 等语句

3、支持在线 DDL

3.1 背景

在 3.20.04.0 或之前版本的 DBLE 中执行 DDL，需要加表锁，若是在集群中，也会通知其他 DDL 加上表锁，加锁期间执行对应表的 SQL 会报错。在 DDL 执行结束后，DBLE 会下发 show create table 得到建表语句，得到建表语句后会解析重新生成元数据，集群中的其他 DBLE 也会执行此操作。

但一部分 SQL 其实对 dble 不造成影响，对 dble 造不造成影响的判断依据在于是否需要更改 dble 中表的元数据，目前 dble 中表的元数据只关心表的列名称，列类型，类是否为 null。若这样的 sql 在 mysql 侧也是 onlineDDL 的，可以无需加锁，直接下发执行，例如增加索引的操作。

3.2ONLINE DDL 的种类

以下列举了 MySQL 8.0 中所有的 ONLINE DDL 以及是否在 DBLE 中支持 ONLINE DDL 模式。

• Index Operations
• Primary Key Operations
• Column Operations
• Generated Column Operations
• Foreign Key Operations
• Table Operations
• Tablespace Operations
• Partitioning Operations
  详细模式介绍请参考文末【参考 3】

三、更新日志（Release Notes）

翻译

特性：

• [#1879] 重构连接池的代码
• [#1863] 支持更多 DML 语句可以被直接将其下推到 MySQL。更多详细信息请参见文末【参考 1】
• [#1849] 重构配置文件：DBLE 的配置文件有很大变化，更多详细信息请参见文末【参考 2】。如果要将旧的配置（必须为2.20.04.x）升级到新的配置，则可以使用名为“ dble_update_config”的工具。
• [#1848] 支持在线 DDL。更多详细信息请参见文末【参考 3】
• [#1846] 通过 WriteToBackendExecutor 在复杂查询中发送查询
• [#1906] DBLE 支持 OGG 工具进行数据同步（alpha 功能）

缺陷修复：

• [#2030] 执行一个复杂的 SQL，其中包含许多并集但会挂起
• [#2029] 当列名称包含中文时，发生错误“field not found:c.成功一”
• [#2025] 错误，当 select 中存在常量时
• [#2022] Round 函数有问题
• [#2021] 多个联合和子查询后，列顺序不正确
• [#1977] 不支持管理命令时，需要在日志中打印查询
• [#1939] 启用 PreparedStatement 后，将对包含 blob，text 等数据类型的表进行多次插入操作；插入的值包含先前 SQL 插入/更新的值。
• [#1926] 如果分片值是十六进制类型，DBLE 将报告错误或路由到错误的节点
• [#1913] 当两个 sharding_table inner join 时，查询 DATEDIFF() 结果不同于单表查询 DATEDIFF()
• [#1820] JDBC 在通过 setblob 或 setBinaryStream 保存图片时遇到了问题，这要感谢 @z3093964447 报告此错误。
• [#1814] 当“load data”失败时，临时文件未被删除
• [#1788] 前端连接超时，可能导致心跳检测失败
• [#1760] 在 XA 事务中执行 DDL 时污染了 MySQL 连接池
• [#1701] 期望默认的 XA 日志名称和 XA 日志直接名称包含“ xa”
• [#1678] show tables 的结果集列名与 MySQL 不符
• [#1658] 当 tempReadHostAvailable ="1"，
  无法正常切换，
  这要感谢 @dairight 报告了该错误

打破向后兼容性：

• [#1849] 重构配置文件：DBLE 的配置文件有很大变化，更多详细信息请参见文末【参考 4】。如果要将旧的配置（必须为 2.20.04.x）升级到新的配置，则可以使用名为“ dble_update_config”的工具。

Release Notes

Features:

• [#1879] Refactor code for connection pool
• [#1863] Support more DML queries which can be pushed down to MySQL directly. More Detail,see 3.SQL_Syntax/3.2_DML
• [#1849] Refactor config files:There are big changes for config files of dble, More Detail,see 1.00_config_file . If you want to upgrade your old configs(must be 2.20.04.x) to new configs， you can use the tool named dble_update_config. .
• [#1848] Support online ddl. More Detail,see online_ddl
• [#1846] send query by WriteToBackendExecutor in complex query
• [#1906] Supports the tool OGG for data synchronization (alpha)

Bug-fixes:

• [#2030] Execute a complex SQL which contains many unions but hang
• [#2029] Occur error"field not found:c.成功一" when the column name contains Chinese
• [#2025] Error when there is constant in select
• [#2022] Round function have problem
• [#2021] After multiple unions and subqueries, the column order is incorrect
• [#1977] The query needs to be printed in the log，when management commands not supported
• [#1939] When PreparedStatement is enabled, multiple insert operations on tables containing data types such as blob、text; the inserted value contains the value of the previous SQL insert/update.
• [#1926] If sharding value is a hex type,dble will report error or route to the wrong node
• [#1913] When two sharding_table inner join , the select DATEDIFF() result is different from one table select DATEDIFF()
• [#1820] JDBC has problems saving pictures via setblob or setBinaryStream , thanks to @z3093964447 for reporting the bug.
• [#1814] When load data failed,the file:temp was left behind
• [#1788] Front connect timeout,may cause heartbeat detection to fail
• [#1760] Contaminate mysql connection pool when doing ddl in xa transaction
• [#1701] Expect the default xa log name and xa log directoty name contain 'xa'
• [#1678] Column name of [show tables] resultset is not consistent with mysql
• [#1658] When tempReadHostAvailable="1",
  show slave status
  not work, thanks to @dairight for reporting the bug.

Breaking backward compatibility:

• [#1849] Refactor config files:There are big changes for config files of dble, More Detail,see1.00_config_file . If you want to upguard your old configs(must be 2.20.04.x) to new configs by tool.

Tips：建议下载最新的 Releases 版本，下载 tar 压缩包即可，如有源码编译需求的，可以下载源码包。我们还发布了几个 bug 修复的小版本 2.19.09.3、 2.19.11.2、2.20.04.2，老版本用户可以考虑小版本升级，风险较低。

---

本次的发版报道就到这里啦~

参考链接：

【参考 1】3.SQL_Syntax / 3.2_DML
https://github.com/actiontech/dble-docs-cn/tree/develop/3.SQL_Syntax/3.2_DML

【参考 2】1.00_config_file
https://github.com/actiontech/dble-docs-cn/blob/develop/1.config_file/1.00_config_file.md

【参考 3】3.1.6 ONLINE DDL
https://github.com/actiontech/dble-docs-cn/blob/develop/3.SQL_Syntax/3.1_DDL/3.1.6_DDL%26online_ddl.md

【参考 4】1.00_config_file
https://github.com/actiontech/dble-docs-cn/blob/develop/1.config_file/1.00_config_file.md