Vitess v19.0.0 版本全解析：MySQL 5.7 停用、ExecuteFetchAsDBA 破坏性变更与查询能力大升级-北京尧图网络

Vitess v19.0.0 版本全解析MySQL 5.7 停用、ExecuteFetchAsDBA 破坏性变更与查询能力大升级【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址: https://gitcode.com/gh_mirrors/vi/vitessVitess v19.0.0 是 Vitess 数据库集群系统的一个重要里程碑版本它在 v18 的基础上大规模增强了 VTGate 查询兼容性多表 DELETE、非递归 CTE、AVG 聚合、新锁语法、正式宣布不再支持 MySQL 5.7、并对ExecuteFetchAsDBA施加了破坏性变更以消除多语句执行带来的连接池脏状态风险。本文以 changelog/19.0/19.0.0/changelog.md 为主体结合同目录 release notes 摘要与仓库源码实现为你逐类梳理 v19.0.0 的 Bug 修复、功能增强、性能优化与升级注意事项帮助你评估是否升级以及升级后如何适配。版本概览与文档结构本 changelog 面向v19.0.0首个 19.0 正式版本此前经历了v19.0.0-RC1代码冻结与候选发布流程。整份变更清单按「类别 × 模块」二维组织共涵盖以下大类和子模块Bug fixesBackup and Restore、Build/CI、CLI、Cluster management、Docker、Evalengine、Examples、General、Observability、Online DDL、Query Serving、Schema Tracker、TabletManager、Throttler、Topology、VReplication、VTCombo、vtctl、vtctldclient、vtexplain、vttestserver。CI/Build构建流程、Docker 镜像、依赖升级。DependabotGo 与 Java 侧依赖自动升级。Documentation文档与发布说明修订。Enhancement跨模块功能增强。Feature Request新功能落地。Internal Cleanup内部重构与死代码清理。Performance性能专项优化。Regression针对 v18 的性能与正确性回退修复。Release版本发布流程相关 PR。Testing测试覆盖扩充与 flaky 修复。下文将先聚焦「公告、弃用与破坏性变更」再深入「查询兼容性与核心功能增强」随后按模块汇总 Bug 修复与性能亮点最后给出升级建议与仓库源码索引。公告Announcementv19 变更总览changelog 的 Announcement 部分#15132指向了同目录下的 summary.md后者系统化列出了 v19 的 Major Changes 与 Minor Changes。这是理解 v19 全貌的第一手材料建议升级前通读。以下各节即依据该摘要展开。重大变更一彻底放弃 MySQL 5.7随着 Oracle 于 2023 年 10 月将 MySQL 5.7 标记为 EOLVitess 自v19 起正式停止对 MySQL 5.7 的支持。官方建议的迁移路径是在仍处于v18版本时先将底层 MySQL 升级到 8.0再升级 Vitess 到 v19。需要特别说明的是v19 仍然支持「从 MySQL 5.7 导入数据到 Vitess」即数据迁移方向的兼容性保留只是不再将其作为运行时的受支持底层数据库。仓库中的示例与镜像也同步向 MySQL 8.0 收敛例如 config/mycnf 目录下保留了mysql80.cnf、mysql84.cnf、mysql90.cnf等 8.x 配置模板而mysql57.cnf依然存在仅供历史参考。重大变更二弃用与删除清单VTTablet 标志删除以下三个自Vitess 7.0起就标记为 deprecated 的 VTTablet 标志在 v19 中被正式删除--vreplication_healthcheck_topology_refresh--vreplication_healthcheck_retry_delay--vreplication_healthcheck_timeout此外--vreplication_tablet_type标志被标记为 deprecated 且被忽略不生效。如果你的脚本或部署清单仍在使用这些标志升级前必须清理。Docker 镜像vitess/lite弃用 mysqldvitess/lite镜像中的mysqld二进制被弃用计划在未来版本移除。这意味着MySQL/Percona 版本特定的镜像 tag 均已弃用。v19.0.0 各 tag 的弃用状态如下ImageDeprecatedvitess/lite:v19.0.0否vitess/lite:v19.0.0-mysql57是vitess/lite:v19.0.0-mysql80是vitess/lite:v19.0.0-percona57是vitess/lite:v19.0.0-percona80是如果你在 vitess-operator 部署中用vitess/lite充当mysqld镜像官方建议改用官方 MySQL 镜像如mysql:8.0.30。以 Kubernetes 清单为例# 升级前该镜像内置 MySQL 8.0.30 及其二进制 mysqld: mysql80Compatible: vitess/lite:v19.0.0-mysql80# 升级后改用官方 MySQL 镜像 mysqld: mysql80Compatible: mysql:8.0.30 # 或 mysql:8.0.34 等另外MYSQL_FLAVOR环境变量已从所有 Docker 镜像中移除。这与MYSQL_FLAVOR的删除清理 PR#14159保持一致Docker 相关构建文件可参考 docker 目录下的Dockerfile.mysql80、Dockerfile.mysql84等。Explain 语句格式移除vitess与vexplain两种 Explain 输出格式自 v16 弃用v19 正式移除。如需分析 Vitess 执行计划请改用VEXPLAIN语句其 CLI 工具入口位于 go/cmd/vtexplain。重大变更三ExecuteFetchAsDBA 拒绝多语句 SQL破坏性变更这是 v19 中最值得关注的破坏性变更vtctldclient ExecuteFetchAsDBA以及vtctl/vtctlclient的同名命令现在会直接拒绝多语句 SQL返回错误且不会执行其中任何一条语句。例如以下命令将直接报错vtctldclient ExecuteFetchAsDBA my-tablet \ stop replica; change replication source to auto_position1; start replica变更背景旧行为的三重隐患v19 之前ExecuteFetchAsDBA会静默接受并尝试执行全部语句但存在三个严重问题错误只报告第一条第 2、3……条语句的错误被静默吞掉连接池脏状态后续语句的结果集未被消费连接归还连接池时处于「脏」状态后续任何查询拿到该连接可能得到意外结果schema 缓存不一致多语句 DDL 只按第一条变更重载 schema导致缓存 schema 与底层数据库不一致。保留的特例CREATE TABLE / CREATE VIEW 序列ExecuteFetchAsDBA仍允许一种多语句场景所有语句均为CREATE TABLE或CREATE VIEW。这是为了支持常见的 schema 初始化模式并已被ApplySchema --batch-size内部使用。从源码看这条路径在 go/vt/vttablet/tabletmanager/rpc_query.go 中实现analyzeExecuteFetchAsDbaMultiQuery将 SQL 拆分为单语句parser.SplitStatementToPieces逐个解析并统计CREATE TABLE/CREATE VIEW数量countCreate随后由validateQueries门控——只有全部为建表/建视图语句的批次才被放行。注意代码注释还指出部分语句如CHANGE REPLICATION SOURCE TO...是「合法不可解析」的解析失败会保留parsedStmts[i] nil以让下游识别。waitForGrantsToHaveApplied保证在执行前等待 DBA 授权完成呼应 Cluster management 下的相关修复与增强。对升级的影响如果你此前依赖ExecuteFetchAsDBA执行多语句 DDL请改用ApplySchema的批量模式或自行拆分语句逐一执行。相关破坏性变更说明见 19.0.0 release notes 中的记录#15021。重大变更四新观测指标v19 引入了两项可观测性改进流式查询合并等待时间此前 VTTablet 只报告非流式执行等待合并consolidation的耗时v19 起流式执行在/debug/vars的Waits.Histograms.StreamConsolidations统计中有了对应指标。其实现位于 go/vt/vttablet/tabletserver/stream_consolidator.go通过waitTimings.Record(StreamConsolidations, startTime)记录。/debug/vars暴露构建版本如19.0.0-SNAPSHOT这样的构建版本号现在会出现在各组件/debug/vars中便于以编程方式在运行时检查二进制版本对应 PR [servenv] 相关增强 #14713。查询兼容性大升级v19 的核心亮点v19 的 Query Serving 增强是本次版本的重头戏全部来自 summary 的 Query Compatibility 章节并与 changelog 中大量 Query Serving 类 PR 相互印证。1. 多表 DELETE 支持分片键空间sharded keyspace新增支持「目标为单表、通过多表 JOIN 过滤」的 DELETEDELETE t1 FROM t1 JOIN t2 ON t1.id t2.id JOIN t3 ON t1.col t3.col WHERE t3.foo 5 AND t2.bar 7;相关实现贯穿多条 PRplanner 侧新增 Multi Table Delete 支持#14855、支持带外键的多表删除#15081、支持与 reference table 的 JOIN#14784、以及在外键存在时带 LIMIT 的删除规划#15097与跨分片DELETE ... LIMIT/ORDER BY#14959。2.SHOW VSCHEMA KEYSPACES查询新增 SQL 语句SHOW VSCHEMA KEYSPACES用于打印所有 keyspace 的 VSchema 信息包括外键模式、是否分片以及 VSchema 是否存在错误。示例输出mysql show vschema keyspaces; ----------------------------------------- | Keyspace | Sharded | Foreign Key | Comment | ----------------------------------------- | ks | true | managed | | | uks | false | managed | | ----------------------------------------- 2 rows in set (0.01 sec)该语法在解析器 go/vt/sqlparser/sql.y 中定义其规划与测试用例见 go/vt/vtgate/planbuilder/testdata/show_cases.json 以及 go/vt/vtgate/executor_vschema_ddl_test.go。3.FOREIGN_KEY_CHECKS成为 Vitess Aware 变量当 VTGate 收到修改会话FOREIGN_KEY_CHECKS的查询时不再把值下推给 MySQL而是由 VTGate 自己跟踪该值并在需要的地方通过SET_VAR(FOREIGN_KEY_CHECKSOn/Off)形式的查询优化器 hint 动态改写查询。这避免了 MySQL 端连接复用导致的全局变量污染相关 PR #14484。4. Explain 支持路由表查询EXPLAIN现在可以处理路由到单表/单 keyspace 的查询当查询涉及的表横跨多个 keyspace时EXPLAIN不被支持应改用VEXPLAIN。5. 部分多分片提交警告在使用默认multi事务模式时Vitess 可能对某个分片提交成功、对后续分片提交失败从而破坏多分片事务的原子性。v19 起VTGate 会对这种部分成功提交产生告警例如mysql commit; ERROR 1317 (70100): target: customer.-80.primary: vttablet: rpc error: code Aborted desc transaction 1703182545849001001: ended at 2023-12-21 14:07:41.515 EST (exceeded timeout: 30s) (CallerID: userData1) mysql show warnings; ------------------------------------------------------------------------- | Level | Code | Message | ------------------------------------------------------------------------- | Warning | 301 | multi-db commit failed after committing to 1 shards: 80- | ------------------------------------------------------------------------- 1 row in set, 1 warning (0.00 sec)该告警在 go/vt/vtgate/tx_conn.go 中生成对应测试覆盖见 go/vt/vtgate/tx_conn_test.go。同时 VTGate 会为部分成功的跨分片提交记录 warning 计数器#14848。6. 新锁语法支持 MySQL 8 的锁读增强语法SELECT ... FOR SHARE (NOWAIT | SKIP LOCKED) SELECT ... FOR UPDATE (NOWAIT | SKIP LOCKED)对应 PR #13965为降低死锁风险外键计划的NOWAIT使用被限制在带唯一键的表上#14772。7. 分片键空间的 AVG() 支持VTGate 现在可以在分片键空间上评估AVG实现方式是组合SUM/COUNT后在 VTGate 侧计算对应 PR #14419。8. 非递归 CTE 支持公共表表达式Common Table Expression非递归形式现在可以使用WITH userCount AS ( SELECT id, COUNT(*) AS nr FROM user GROUP BY id) SELECT ref.col, userCount.nr FROM ref JOIN userCount ON ref.user_id userCount.id;对应 PR #14321后续还修复了 UNION 语句与 CTE 组合的规划问题#15324。9. 其他值得关注的查询增强GROUP_CONCAT 与多表达式 COUNT DISTINCT#14851不可见列invisible columns支持#14366派生表显式列别名#14129哈希 JOIN 用于嵌套循环不可行的场景并持续优化#14448、#14644外键循环/环检测#14339、#15062与更细粒度的外键引用错误#14682REPLACE INTO引擎启用并修复外键锁问题#14532INSERT ... ON DUPLICATE KEY UPDATE 的外键支持#14638Schema Tracking 改为大小写敏感#14904。集群管理增强PlannedReparentShard 新增--tolerable-replication-lagPlannedReparentShard命令新增子标志--tolerable-replication-lag用于指定候选提升 tablet 可接受的最大复制延迟当 Vitess 选择新主时延迟超过该值的 tablet 将不被选为候选。该功能默认关闭opt-in不指定此标志时 Vitess 完全忽略复制延迟。VTOrc 也新增同名标志用于控制 VTOrc 发起的PlannedReparentShard调用行为。相关代码见 go/vt/vtctl/reparent.go、go/vt/vtctl/grpcvtctldserver/server.go 与 go/vt/vtorc/config/config.go。配套修复包括即使显式指定了新主PRS 也尊重可容忍复制延迟#15090、选择主候选时考虑复制延迟#14634。其他集群管理要点vttablet 会等待vt_dba用户授权完成再提供服务#14565并修复了相关阻塞问题#14836外部 tablet 可跳过该等待#14629修复 PRSPlannedReparentShard中的 nil 检查 panic#14656修复 heartbeatWriter 在半同步 ACK 等待中的卡死#14823VTGate UI 新增健康检查healthy映射展示#14521VTGate 实例可优雅关停#14219。Online DDL 增强v19 在 Online DDL 上投入了大量工作支持DROP FOREIGN KEY语句#14338在底层 MySQL 包含相应补丁时默认启用 Online DDL 外键支持#14370支持迁移切换退避与强制切换migration cut-over backoff and forced cut-over#14546TableGC 通过RequestChecks()加速迁移产物清理#14431schemadiff 引入InstantDDLCapability形式化 MySQL 能力#14900并据此判断 schema 变更是否可即时应用#14878支持EnumReorderStrategy检测枚举/集合值序号的改变#15106所有 gRPC 调用增加超时#14182修复迁移卡死而非直接失败的问题#14290schemadiff 修复多处约束 diff 问题如缺失DROP CONSTRAINT#14387、文本列隐式字符集 diff#14930、char→varchar 外键引用类型匹配#14849。Evalengine 表达式引擎正确性与新函数EvalengineVTGate 内的 SQL 表达式求值引擎在 v19 获得大量修复与增强修复零日期处理#14610、decimal 的 min/max 计算#14614、week 溢出#14859、可空性检查#14556、当前日期/时间返回 evalTemporal 类型#15079新函数实现SUBSTRING#14899、FROM_DAYS#15058、TO_DAYS#15065、MID别名#15066、TIME_TO_SEC#15094、LAST_DAY#15038改进函数类型推断#14533与AggregateEvalTypes#15085性能Tiny Weights#14402。VReplication / VDiff 增强与修复VReplication 在 v19 同样动作频繁RowStreamer 索引优化优先使用最优索引并发送唯一键名以便FORCE INDEX#13893、#14916VDiff 增强--max-report-sample-rows#14437、按表设置最大 diff 时长#14786、支持无主键表的 diff#14794、show all限定 keyspace/workflow#14442批处理VPlayer 支持语句与事务批处理#14502会话设置高 net read/write timeout#14203安全性防护不安全的_vt.vreplication写入#14797流量切换修复 SwitchReads 在 SwitchTraffic 全量切换时误切写流量的问题#14360、SwitchWrites 正确返回错误#14800命令迁移CreateLookupVindex、ExternalizeVindex迁移到 vtctldclient#14086vtctldclient workflow SHOW 输出补充信息#14225。性能优化v19 的性能工作集中在连接池、协议层与拓扑层改进连接池Improved Connection Pooling#14034MySQL 客户端写路径不再分配内存#14482parseOKPacket减少多次分配#15067、#15082strings.Builder替换bytes.Buffer#14539拓扑层FindAllShardsInKeyspace并发化#14670并整体优化 TopoServer 对 keyspace shards 的性能#15047健康检查改用GetTabletsByCell#14693Throttler 使用 tmclient 连接池调用CheckThrottlerRPC#14979防止 vtctld 在备份恢复时创建大量 S3 连接#15401。备份恢复、Throttler 与 Schema Tracker 要点备份恢复实现缺失的ReadBinlogFilesTimestamps函数#14525--incremental-from-pos支持备份名#14923增量备份不再对空备份报错#15022修复读取 mysqlbinlog 输出的竞态#14330。Throttlerv18 重构后的竞态修复与单元/竞态测试#14181gRPC 与 topo 通信超时#14165修复 nil 指针解引用#15181示例中移除 heartbeat 标志#14980。Schema Tracker修复 nil server vschema 导致的崩溃#15086。TabletManager清理陈旧的 socket lockfile#14553、#14600支持传入 MySQL 关停超时#14568。vttestserver 与命令行工具--vtcombo-bind-host新标志vttestserver 新增该标志用于配置 vtcombo 的绑定地址在容器化Docker场景下尤其有用——便于从宿主机执行 vtctld 命令、查看 vtcombo 的/debug/status仪表盘。源码位置 go/cmd/vttestserver/cli/main.go默认值为localhost。ApplyVSchema --strictvtctl ApplyVSchema新增--strict子标志发现 Vindex 中的未知参数即报错vtctld ApplyVSchemagRPC 命令新增等价strict字段#14862。vtctldclient支持集群引导#14315GetTablets应用 keyspaceshard 的 tablet 类型过滤#14467GetShardReplication命令#15390。vtexplain修复列信息设置与内存 topo#15282、#15285。VTAdmin新增 onlineddl 端点#15114优化GetWorkflowsRPC#14212。构建、CI 与依赖Go 版本开发主线从go1.21.2逐步升级至go1.21.5release-19.0 分支最终升级到go1.22.1#15406go.mod 中的 toolchain 也同步更新#15246。Docker新增 Vitess MySQL Docker 镜像#14158vitess/lite、vitess/base及组件镜像改由 GitHub Actions 构建推送#14243、#14271新增专用 vtorc 容器#14126。依赖升级gRPC 升级至 1.59.0#14364、golang.org/x/net0.17.0#14260等Java 侧升级 guava、netty-handler#14759、#14863。CI支持自动批准vitess-bot干净 backport#14352每周自动升级 Go 依赖#14910重新启用 FOSSA 扫描并加入 Codecov#14333。内部清理与工程质量v19 包含大量工程化清理Keyspace ServedFrom弃用属性及关联代码移除#14694servenv从 mysql、collations、sqlparser 等模块中逐步剥离#14732、#14781、#14822引入vtenv统一传递 collation 与 parser 信息#14994移除未使用的 EventStreamer#14783vitess/go/maps2迁移到golang.org/x/exp/maps#14960大量 nilness 静态检查修复覆盖 vtgate、vttablet、vtadmin、topo、wrangler、vtctl 等包同时为go/acl、go/stats、go/mathstats、go/json2、go/sqltypes等大量基础包补齐了测试。升级到 v19 的注意事项汇总底层数据库先在 v18 上将 MySQL 5.7 升级到 8.0再升级 Vitess 到 v19v19 不再支持 MySQL 5.7 运行时。清理废弃标志移除 VTTablet 的--vreplication_healthcheck_*三个标志--vreplication_tablet_type已失效。适配 ExecuteFetchAsDBA 破坏性变更多语句执行将直接报错仅CREATE TABLE/VIEW序列被放行批量 DDL 请走ApplySchema --batch-size。Docker 镜像vitess/lite的mysqld已弃用版本特定 tag-mysql57、-mysql80、-percona57、-percona80全部标记弃用改用官方 MySQL 镜像。Explain 格式vitess/vexplain输出格式已移除改用VEXPLAIN。多分片事务告警multi模式下部分提交失败会以 warning 形式暴露建议将SHOW WARNINGS纳入运维观测。如需查看更多版本信息可查阅 changelog/19.0 目录下的各 patch 版本 changelog 与 release notes本仓库当前主线代码结构可参考 go/vt/vtgate查询路径、go/vt/vttablettablet 侧与 go/vt/wranglerVReplication/切换编排等核心目录。【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址: https://gitcode.com/gh_mirrors/vi/vitess创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Vitess v19.0.0 版本全解析：MySQL 5.7 停用、ExecuteFetchAsDBA 破坏性变更与查询能力大升级

相关推荐

Roc 编译器快照测试剖析：`if True 1 else 2` 与 “Unconditional Condition“ 编译期警告

航空实验班源码图解：3步解决复制代码跑不通痛点

Maven插件避坑指南：3个痛点让你从入门到精通的保姆级教程

更多资讯

5个音频库实测:音响设计实战项目完整示例选型指南

Link2SD下载全攻略：从入门到精通避开版本API变更大坑

拒绝硬画:3步搞定初等函数图像渲染,性能提升5倍

告别只会背概念，这份蜡烛图保姆级教程带你搞定底层逻辑

2016年2月日历图解原理：3个代码坑让你加班到凌晨

登天论坛源码拆解：3个面试必问核心机制

今日更新

OneUptime 自定义探针（Custom Probe）部署实战：私网监控、代理配置与断连排障全指南

大众TL52625前端框架材料要求详解：从性能测试到落地执行

TiXL 浮点运算算子库 Lib.numbers.float 完全指南：44 个算子的参数详解、源码原理与实战串联

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？