分布式 | DBLE Release Notes 详细解读 2.19.07.0

2.19.07.0 版本 DBLE Release Notes

一、DBLE 项目介绍

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

DBLE 官方项目：    
https://github.com/actiontech/dble    
如对源码有兴趣或者需要定制的功能的可以通过源码编译安装

DBLE 官方文档（已更新）：    
https://actiontech.github.io/dble-docs-cn    
可以详细了解 DBLE 的背景和应用场景，本文未涉及到的细节都可在官方文档获得

DBLE 下载地址：    
https://github.com/actiontech/dble/releases

点击学习 DBLE 公开课，Mycat 用户更快上手哦！

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

二、新版本概况

上一次发版(2.19.05.0) （7 月 2 日）仿佛就在昨天，DBLE 社区就又双叒叕迎来了新版本的更新；最新的 Release Notes 请参考：

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

新增或重构功能 10 个，修复缺陷 22 个，向后兼容性调整 4 处；

首先，感谢以下人员对社区做出的贡献：
@kaikai2000, @Lordess, @ssxlulu, @canying8020, @newskyddm, @wbshen
再次，感谢 Github 用户提供的优质 issue
最后，感谢在 QQ 群（669663113）提供的有效反馈的朋友

三、版本主要更新解读

1、支持更丰富的数据导入导出方式（issue #1264）

支持工具

workbench
dbeaver
mysqldump
navicat
导入数据也可以使用 MySQL 中的 source 和 load data 命令

注意点

若使用 mysqldump 导出时，请按照以下格式进行导出，否则可能出现错误，因为有些 mysqldump 参数 DBLE 不支持。
./mysqldump -h127.0.0.1 -utest -P3306 -p111111 --default-character-set=utf8mb4 --master-data=2 \
--single-transaction --set-gtid-purged=off --hex-blob --databases schema1 > export.sql
导入时，脚本中若存在非注释性的视图相关语句，需要注释掉或删除。
导出时，因为 DBLE 对视图相关的一些语句不支持，因此尽量确保导出的 DBLE 中不存在视图。

2、更加完善的 show 命令（issue #759）

添加管理器命令：
- show @@user,show @@user.privilege
修改管理器命令：
- show @@datasource
- show @@datasource.synstatus
- show @@datasource.syndetail where name=?
- show @@datasource.cluster

3、文本协议支持新增（issue #1356 & #1326）

COM_CHANGE_USER：重置连接并使用给定的凭证重新进行身份验证
COM_RESET_CONNECTION：无需重新身份认证即可重连
- 关闭后端连接(rollback & unlock)
- 事务状态情况
- 用户变量清空
- 系统变量恢复成系统默认值
- prepare 清空
- 上下文（字符集/隔离级别）恢复成为默认值
- LAST_INSERT_ID 置零
COM_SET_OPTION：用来启用或禁用服务的选项

四、完整 Release Notes 及翻译

更新列表：

[#1263] 添加命令 release @@reload_metadata 和 show @@reload_status 实现重载功能
[#1264] 支持更丰富的数据导入导出方式
[#1332] 支持创建 FUNCTION，类似创建 PROCEDURE
[#1356] 文本协议支持 COM_CHANGE_USER 和 COM_RESET_CONNECTION
[#1326] 文本协议支持 COM_SET_OPTION
[#1340] 重构心跳检测逻辑
[#759] 更加完善的 show 命令
[#1342] 修改在管理器命令和日志中包含 connection ID 列的名称
[#1266] gc 日志不会在重启 DBLE 时候被覆盖
[#877] 支持创建 SAVEPOINT，谢谢 @wbshen 报告这个问题

缺陷修复：

[#1383] reload @@config_all 失败可能导致新添加的配置中的datahost的连接泄露
[#1184] 由分布式时间戳生成的全局序列可能具有重复的值
[#1212] 在 zk 集群中重新启动 DBLE 可能失败
[#1286] 参数 sqlExecuteTimeout 无效
[#1229] 当在不同的表中出现大小写字母时，连接返回空，缺少结果集，谢谢 @kaikai2000 报告错误
[#1368] 无论加密失败与否，结果总是返回真，感谢 @Lordess 报告并修复错误
[#1327] 复杂的选择列可能导致在连接查询中“找不到错误“
[#1351] 不共享表的与联合的子查询应视为简单查询
[#1241] 在库命名中有“-”时报错
[#1261] 多 SQL 任务不是安全线程并且计数间隔不匹配，可能导致服务重载挂起
[#1322] 用相同的数据主机和相同的数据库检查不同的数据节点
[#1300] 类PhysicalDBPool中的initSource方法的提示不正确
[#1306] 当执行 SQL "select a.* from sharding_4_t1 a ,schema2.sharding_4_t2 b where a.id = b.id and b.name = '1';" 时将获取错误信息
[#1301] 当执行 SQL "select t1.id from DbTest.Test_Table T1 left join Test t2 on t1.id=t2.Id;" 时 DBLE 会获取 NPE 的错误信息
[#1280] 在当前数据库中创建的视图不能与其他数据库中的表关联，也不能添加数据库前缀，谢谢 @canying8020 报告错误
[#1250] 表的空间存在于文件中时，载入数据的默认字段会失败
[#1288] 全局表，在执行 "select a.id,b.* from schema2.test2 a inner join test1 b on a.id+1 =b.id+2;" 时出现错误
[#1251] 分析 er 表中的子表，语句实际上已执行
[#1255] 当执行 SQL "select a.id,b.* from test2 a inner join test1 b on a.id =b.id+1;" 时发生错误，谢谢 @newskyddm 错误报告
[#1256] 当执行 SQL "select test1.id,test1.id+1 as rpda_0 from test1 order by rpda_0 ASC" 时发生错误，谢谢 @newskyddm 报告错误
[#960] 非共享表，在执行 SQL "SELECT CURRENT_USER() union select id from test1" 时得到结果是错误的
[#1268] 全局表，在执行 "select count(*) from (select O_CUSTKEY,count(O_CUSTKEY) as counts from test1 group by O_CUSTKEY) as a where counts<10 group by counts;" 时出现错误

兼容性：

[#759] show @@datasource,show @@datasource.synstatus,show @@datasource.syndetail where name=?,show @@datasource.cluster 添加 DATAHOST 列
[#1272] 删除 server.xml 中的属性 useOldMetaInit
[#1291] 将默认字符集从 UTF8 更改为 Utf8mb4
[#1260] 重构 XML 配置文件中的属性 version

Release Notes:

Features:

[#1263] Add command release @@reload_metadata and show @@reload_status to make reload observable
[#1264] Support more ways for exporting and importing data
[#1332] Support create FUNCTION just like create PROCEDURE.
[#1356] Support COM_CHANGE_USER and COM_RESET_CONNECTION
[#1326] Support COM_SET_OPTION
[#1340] Refactor heartbeat logic
[#759] Add manager command:show @@user,show @@user.privilege,modify manager command:show @@datasource,show @@datasource.synstatus,show @@datasource.syndetail where name=?,show @@datasource.cluster
[#1340] Refactor heartbeat logic
[#1342] Modify column name that contains connection id in manager command and log
[#1266] Provious gc log can't be overried when user restarts dble.
[#877] Support statement SAVEPOINT, thanks @wbshen report this issue

Bug-fixes:

[#1383] reload @@config_all failed may lead to connections for new added datahost in config leaking.
[#1184] Global sequences generated by distributed timestamps may have duplicate values.
[#1212] Restart dble may fail in zk cluster.
[#1286] Parameter sqlExecuteTimeout is invalid.
[#1229] When there are lowercase and uppercase in the field in differernt table, Join returns null, missing result set, thanks @kaikai2000 report the bug.
[#1368] encrypt.sh always return true whether the encryption failed or not, thanks @Lordess report and fix the bug.
[#1327] Complex select columns may lead "can not find error" in join query.
[#1351] No-sharding table's sub-query with union should be treated as simple query.
[#1241] Report error when '-' in the name of schema.
[#1261] MultiSQLJob is not thread safe & countDownShardTable not correct, may cause reload hang.
[#1322] Check different dataNodes with same dataHost and same database.
[#1300] Incorrect comment in initSource method of class PhysicalDBPool, thanks @ssxlulu report and fix the bug.
[#1306] Got error while executing sql"select a.* from sharding_4_t1 a ,schema2.sharding_4_t2 b where a.id = b.id and b.name = '1';"
[#1301] dble will got NPE error while executing the sql "select t1.id from DbTest.Test_Table T1 left join Test t2 on t1.id=t2.Id;"
[#1280] Views created in the current database cannot be associated with tables in another database, and database prefixes cannot be added, thanks @canying8020 report the bug.
[#1250] Load data incorrect with default fields terminate when tab's space exists in file
[#1288] For global table, got error while execute "select a.id,b.* from schema2.test2 a inner join test1 b on a.id+1 =b.id+2;"
[#1251] Explain the child table in the er table, the statement is actually executed
[#1255] Error when execute "select a.id,b.* from test2 a inner join test1 b on a.id =b.id+1;", thanks @newskyddm report the bug.
[#1256] Error when execute "select test1.id,test1.id+1 as rpda_0 from test1 order by rpda_0 ASC", thanks @newskyddm report the bug.
[#960] For no-sharding table, got wrong result while executing sql "SELECT CURRENT_USER() union select id from test1"
[#1268] For global table, got error while executing "select count(*) from (select O_CUSTKEY,count(O_CUSTKEY) as counts from test1 group by O_CUSTKEY) as a where counts<10 group by counts;"

Breaking backward compatibility:

[#759] show @@datasource,show @@datasource.synstatus,show @@datasource.syndetail where name=?,show @@datasource.cluster add DATAHOST column
[#1272] Remove the property useOldMetaInit in server.xml.
[#1291] Change the default charset from utf8 to utf8mb4.
[#1260] Refactoring attribute 'version' in xml config