版本发布 - 分布式 | DBLE 3.20.07.0 来啦！ - MySQL分布式中间件DBLE

3.20.07.0 版本 DBLE Release Notes

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

https://github.com/actiontech...

一、DBLE 项目介绍

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

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

官方课程：

点击学习《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...
【参考 2】1.00_config_file
https://github.com/actiontech...
【参考 3】3.1.6 ONLINE DDL
https://github.com/actiontech...
【参考 4】1.00_config_file
https://github.com/actiontech...

分布式 | DBLE 3.20.07.0 来啦！