数据库分布式数据库云原生后端数据存储【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址https://gitcode.com/gh_mirrors/vi/vitess点击查看免费下载本文基于官方发布说明与仓库源码系统性解读 Vitess v17.0.6 中最关键的破坏性变更——ExecuteFetchAsDBA命令不再静默接受多语句 SQL以及这一变更背后的工程动机、底层实现与升级迁移建议。一、发布背景Vitess v17.0.6 是 17.0 系列的一个补丁版本共合并了 24 个 Pull Request主要涵盖 Evalengine 溢出与时间类型修复、Query Serving 的 goroutine 泄漏修复、Online DDL 的 enum 值重排、vtexplain/vttestserver 修正等2。在全部变更中唯一被官方标记为Breaking Changes破坏性变更的是ExecuteFetchAsDBA拒绝多语句 SQL1该修复来自 PRProtect ExecuteFetchAsDBA against multi-statements, excluding a sequence of CREATE TABLE|VIEW2直接改变了 DBA 运维命令的行为契约因此被单列为 17.0.6 的破坏性变更写入发布说明所有升级用户在升级前都应当知晓这一变化。二、变更内容从静默接受到显式拒绝2.1 受影响命令本次变更同时作用于三类入口发布说明明确点名vtctldclient ExecuteFetchAsDBA新一代 vtctld 客户端命令vtctl ExecuteFetchAsDbavtctlclient ExecuteFetchAsDba2.2 变更后的行为升级到 v17.0.6 之后向上述任一命令传入分号分隔的多条 SQL将直接返回错误并且不会执行其中的任何一条语句。发布说明给出的示例vtctldclient ExecuteFetchAsDBA my-tablet stop replica; change replication source to auto_position1; start replica该命令会立即报错stop replica、change replication source to auto_position1、start replica三条语句均不会被执行从而从源头杜绝了部分执行造成的中间状态。2.3 唯一例外CREATE TABLE / CREATE VIEW 序列ExecuteFetchAsDBA仍然允许一种特定形式的多语句 SQL——当所有语句都是CREATE TABLE或CREATE VIEW时。这是为了支撑一次提交建表脚本进行 schema 初始化这一常见运维模式。三、为什么是破坏性变更旧行为的三大隐患发布说明清晰陈述了旧版v17.0.6 之前ExecuteFetchAsDBA静默执行多语句 SQL 时存在的三个问题这正是本变更的工程动机3.1 错误被截断只报第一条语句的错误旧实现会尝试执行全部语句但只对第一条语句返回错误第 2、3 条及之后的语句即使失败也会被静默忽略。DBA 很可能误以为整个批次执行成功而实际上后续变更可能已悄然失败。3.2 连接池脏状态结果集未消费导致连接复用污染旧实现不会消费第 2、3 条及之后语句产生的结果集随后将这条已被污染的连接归还连接池。之后任何恰好从池中取到该连接的查询都可能读到残留结果或处于错误的会话状态引发难以排查的幽灵问题。3.3 Schema 缓存不一致只按第一条变更重载多语句的 schema 变更执行后tablet 只会以第一条变更的结果重载 schema导致 vttablet 缓存的 schema 与底层 MySQL 实际 schema 不一致进而影响查询路由与规划的正确性。四、源码级剖析新行为在仓库中如何落地虽然本仓库当前代码已演化到更晚的版本其中注释明确提到 As of v23 we do not allow multi-statement SQL in ExecuteFetchAsDba at all但 v17.0.6 引入的**解析、校验、再执行的核心架构**被完整保留可以直接作为本次变更的源码证据。4.1 完整调用链vtctldclient ExecuteFetchAsDBA └─ VtctldServer.ExecuteFetchAsDBA (go/vt/vtctl/grpcvtctldserver/server.go#L1396) └─ tmc.ExecuteFetchAsDba ──gRPC──▶ TabletManager.ExecuteFetchAsDba (go/vt/vttablet/tabletmanager/rpc_query.go#L246) └─ executeMultiFetchAsDba (同一文件#L109) └─ validateQueries 回调len(queries) 1 即报错VtctldServer.ExecuteFetchAsDBA负责解析 tablet 别名、构造请求并透传三个控制参数MaxRows、DisableBinlogs、ReloadSchema见 server.go。TabletManager.ExecuteFetchAsDba是最终执行入口见 rpc_query.go。4.2 关键校验逻辑在ExecuteFetchAsDba中一个名为validateQueries的回调被注入executeMultiFetchAsDba其实现为func(queries []string, countCreate int) error { if len(queries) 1 { return vterrors.Errorf(vtrpc.Code_INVALID_ARGUMENT, multi statement queries are not supported in ExecuteFetchAsDba) } return nil }即先用 SQL parser 将输入按分号拆分为语句列表SplitStatementToPieces一旦发现多于一条语句直接返回INVALID_ARGUMENT错误且在获取任何 MySQL 连接之前完成校验。注释表明这样做的好处是被拒绝的批次不会浪费一次连接获取及后续的SET sql_log_bin、USE等往返开销见 rpc_query.go。4.3 语句拆分与分析analyzeExecuteFetchAsDbaMultiQueryrpc_query.go承担拆分与语法分析职责将 SQL 拆为多条语句并逐条尝试解析AST统计其中CREATE TABLE/CREATE VIEW语句的数量countCreate——这正是 v17.0.6 CREATE 序列例外 判断的基础记录每条语句是否可解析——某些合法语句如CHANGE REPLICATION SOURCE TO...当前解析器无法解析会被标记为不可解析但不报错探测/*vt allowZeroInDatetrue */指令。与之配套的单测TestAnalyzeExecuteFetchAsDbaMultiQueryrpc_query_test.go)逐一验证了多种输入形态输入 SQL拆分条数可解析全部为 CREATE空串报错——select * from t1 ; select * from t22是否create table t(id int)1是是create table t(id int); create view v as select 1 from dual2是是create table ...; create view ...; drop table t33是否stop replica; start replica2否否可以看到多 CREATE 语句放行与非 CREATE 多语句拒绝的边界在测试中被严格锁定。4.4 命令与协议定义vtctldclientExecuteFetchAsDBA命令定义于 go/cmd/vtctldclient/command/query.go并注册ExecuteFetchAsDba作为别名同文件中还提供了专用于多语句场景的ExecuteMultiFetchAsDBA别名ExecuteMultiFetchAsDba见同文件 #L49-L57。vtctl旧式命令ExecuteFetchAsDba定义于 go/vt/vtctl/vtctl.go最终同样经由Wrangler.ExecuteFetchAsDbago/vt/wrangler/tablet.go转发到 vtctld server。协议层ExecuteFetchAsDBARequest/ExecuteMultiFetchAsDBARequest定义于 proto/vtctldata.proto其中明确注释ExecuteMultiFetchAsDBARequest.sql是 SQL could have potentially multiple queries separated by semicolons而ExecuteFetchAsDBARequest.query无此说明——从协议注释层面即可看出二者职责的分野。五、命令参数速查三个命令均以 tablet 别名 SQL 字符串为必填参数可选参数一致以 vtctldclient 为例来源 go/cmd/vtctldclient/command/query.go参数默认值说明--max-rows10000读取结果的最大行数注意它并不给查询附加 LIMIT只是限制从 MySQL 读入的行数--disable-binlogsfalse执行期间关闭 binary logging对应 MySQL 侧SET sql_log_bin OFF--reload-schemafalse执行后指示 tablet 重载 schema--json/-jfalse以 JSON 而非人读表格输出结果六、升级迁移建议拆分多语句为单条执行将脚本中的多语句批次逐条调用ExecuteFetchAsDBA避免触发拒绝错误。schema 初始化脚本继续使用多语句只要批次中全部语句均为CREATE TABLE/CREATE VIEW旧有初始化模式不受影响。需要执行混合 DDL/DML 批次时改用ExecuteMultiFetchAsDBA该命令被设计为多语句专用入口返回多条QueryResult并额外支持会话变量注入与foreign_key_checks开关见 executeMultiFetchAsDba 的执行流程。注意ExecuteMultiFetchAsDBA从更晚的版本才开始提供使用前请确认集群版本支持。长期演进仓库当前代码的注释显示后续版本v23 起将彻底禁止ExecuteFetchAsDba的多语句用法多语句执行将完全收敛到ExecuteMultiFetchAsDba唯一入口见 rpc_query.go。v17 用户可借此变更提前改造脚本平滑过渡。七、结语ExecuteFetchAsDBA拒绝多语句 SQL 是一次典型的以破坏性变更换取确定性的工程决策它牺牲了旧行为的便利性换来了错误上报的完整性、连接池的洁净以及 schema 缓存的一致性。对 Vitess 集群运维者而言理解这一变更的边界非 CREATE 多语句拒绝、CREATE 序列放行、ExecuteMultiFetchAsDBA补位是顺利完成 v17.0.6 升级的关键。详见 changelog/17.0/17.0.6/release_notes.md。↩详见本仓库内完整 changelogchangelog/17.0/17.0.6/changelog.md对应 PR #14983 / #14954。↩ ↩赞分享数据库分布式数据库云原生后端数据存储【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址https://gitcode.com/gh_mirrors/vi/vitess点击查看免费下载相关推荐SvelteKit goto 破坏性变更解析调用不存在的路由时将拒绝导航SvelteKit goto 破坏性变更解析调用不存在的路由时将拒绝导航 本篇文章围绕 SvelteKit 仓库中的 changeset 文件 goto erWeb框架后端前端Vitess v18.0.3 版本全解析ExecuteFetchAsDBA 多语句加固与 47 项修复的实战指南Vitess v18.0.3 版本全解析ExecuteFetchAsDBA 多语句加固与 47 项修复的实战指南 v18.0.3 是 Vitess 18.0数据库分布式数据库云原生后端数据存储Vitess 15.0 升级指南破坏性变更、新特性与迁移实操全解析Vitess 15.0 升级指南破坏性变更、新特性与迁移实操全解析 本篇技术指南以 Vitess 15.0.0 官方 Release Summary 为主体骨数据库分布式数据库云原生后端数据存储创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
数据库分布式数据库云原生后端数据存储【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址https://gitcode.com/gh_mirrors/vi/vitess点击查看免费下载本文基于官方发布说明与仓库源码系统性解读 Vitess v17.0.6 中最关键的破坏性变更——ExecuteFetchAsDBA命令不再静默接受多语句 SQL以及这一变更背后的工程动机、底层实现与升级迁移建议。一、发布背景Vitess v17.0.6 是 17.0 系列的一个补丁版本共合并了 24 个 Pull Request主要涵盖 Evalengine 溢出与时间类型修复、Query Serving 的 goroutine 泄漏修复、Online DDL 的 enum 值重排、vtexplain/vttestserver 修正等2。在全部变更中唯一被官方标记为Breaking Changes破坏性变更的是ExecuteFetchAsDBA拒绝多语句 SQL1该修复来自 PRProtect ExecuteFetchAsDBA against multi-statements, excluding a sequence of CREATE TABLE|VIEW2直接改变了 DBA 运维命令的行为契约因此被单列为 17.0.6 的破坏性变更写入发布说明所有升级用户在升级前都应当知晓这一变化。二、变更内容从静默接受到显式拒绝2.1 受影响命令本次变更同时作用于三类入口发布说明明确点名vtctldclient ExecuteFetchAsDBA新一代 vtctld 客户端命令vtctl ExecuteFetchAsDbavtctlclient ExecuteFetchAsDba2.2 变更后的行为升级到 v17.0.6 之后向上述任一命令传入分号分隔的多条 SQL将直接返回错误并且不会执行其中的任何一条语句。发布说明给出的示例vtctldclient ExecuteFetchAsDBA my-tablet stop replica; change replication source to auto_position1; start replica该命令会立即报错stop replica、change replication source to auto_position1、start replica三条语句均不会被执行从而从源头杜绝了部分执行造成的中间状态。2.3 唯一例外CREATE TABLE / CREATE VIEW 序列ExecuteFetchAsDBA仍然允许一种特定形式的多语句 SQL——当所有语句都是CREATE TABLE或CREATE VIEW时。这是为了支撑一次提交建表脚本进行 schema 初始化这一常见运维模式。三、为什么是破坏性变更旧行为的三大隐患发布说明清晰陈述了旧版v17.0.6 之前ExecuteFetchAsDBA静默执行多语句 SQL 时存在的三个问题这正是本变更的工程动机3.1 错误被截断只报第一条语句的错误旧实现会尝试执行全部语句但只对第一条语句返回错误第 2、3 条及之后的语句即使失败也会被静默忽略。DBA 很可能误以为整个批次执行成功而实际上后续变更可能已悄然失败。3.2 连接池脏状态结果集未消费导致连接复用污染旧实现不会消费第 2、3 条及之后语句产生的结果集随后将这条已被污染的连接归还连接池。之后任何恰好从池中取到该连接的查询都可能读到残留结果或处于错误的会话状态引发难以排查的幽灵问题。3.3 Schema 缓存不一致只按第一条变更重载多语句的 schema 变更执行后tablet 只会以第一条变更的结果重载 schema导致 vttablet 缓存的 schema 与底层 MySQL 实际 schema 不一致进而影响查询路由与规划的正确性。四、源码级剖析新行为在仓库中如何落地虽然本仓库当前代码已演化到更晚的版本其中注释明确提到 As of v23 we do not allow multi-statement SQL in ExecuteFetchAsDba at all但 v17.0.6 引入的**解析、校验、再执行的核心架构**被完整保留可以直接作为本次变更的源码证据。4.1 完整调用链vtctldclient ExecuteFetchAsDBA └─ VtctldServer.ExecuteFetchAsDBA (go/vt/vtctl/grpcvtctldserver/server.go#L1396) └─ tmc.ExecuteFetchAsDba ──gRPC──▶ TabletManager.ExecuteFetchAsDba (go/vt/vttablet/tabletmanager/rpc_query.go#L246) └─ executeMultiFetchAsDba (同一文件#L109) └─ validateQueries 回调len(queries) 1 即报错VtctldServer.ExecuteFetchAsDBA负责解析 tablet 别名、构造请求并透传三个控制参数MaxRows、DisableBinlogs、ReloadSchema见 server.go。TabletManager.ExecuteFetchAsDba是最终执行入口见 rpc_query.go。4.2 关键校验逻辑在ExecuteFetchAsDba中一个名为validateQueries的回调被注入executeMultiFetchAsDba其实现为func(queries []string, countCreate int) error { if len(queries) 1 { return vterrors.Errorf(vtrpc.Code_INVALID_ARGUMENT, multi statement queries are not supported in ExecuteFetchAsDba) } return nil }即先用 SQL parser 将输入按分号拆分为语句列表SplitStatementToPieces一旦发现多于一条语句直接返回INVALID_ARGUMENT错误且在获取任何 MySQL 连接之前完成校验。注释表明这样做的好处是被拒绝的批次不会浪费一次连接获取及后续的SET sql_log_bin、USE等往返开销见 rpc_query.go。4.3 语句拆分与分析analyzeExecuteFetchAsDbaMultiQueryrpc_query.go承担拆分与语法分析职责将 SQL 拆为多条语句并逐条尝试解析AST统计其中CREATE TABLE/CREATE VIEW语句的数量countCreate——这正是 v17.0.6 CREATE 序列例外 判断的基础记录每条语句是否可解析——某些合法语句如CHANGE REPLICATION SOURCE TO...当前解析器无法解析会被标记为不可解析但不报错探测/*vt allowZeroInDatetrue */指令。与之配套的单测TestAnalyzeExecuteFetchAsDbaMultiQueryrpc_query_test.go)逐一验证了多种输入形态输入 SQL拆分条数可解析全部为 CREATE空串报错——select * from t1 ; select * from t22是否create table t(id int)1是是create table t(id int); create view v as select 1 from dual2是是create table ...; create view ...; drop table t33是否stop replica; start replica2否否可以看到多 CREATE 语句放行与非 CREATE 多语句拒绝的边界在测试中被严格锁定。4.4 命令与协议定义vtctldclientExecuteFetchAsDBA命令定义于 go/cmd/vtctldclient/command/query.go并注册ExecuteFetchAsDba作为别名同文件中还提供了专用于多语句场景的ExecuteMultiFetchAsDBA别名ExecuteMultiFetchAsDba见同文件 #L49-L57。vtctl旧式命令ExecuteFetchAsDba定义于 go/vt/vtctl/vtctl.go最终同样经由Wrangler.ExecuteFetchAsDbago/vt/wrangler/tablet.go转发到 vtctld server。协议层ExecuteFetchAsDBARequest/ExecuteMultiFetchAsDBARequest定义于 proto/vtctldata.proto其中明确注释ExecuteMultiFetchAsDBARequest.sql是 SQL could have potentially multiple queries separated by semicolons而ExecuteFetchAsDBARequest.query无此说明——从协议注释层面即可看出二者职责的分野。五、命令参数速查三个命令均以 tablet 别名 SQL 字符串为必填参数可选参数一致以 vtctldclient 为例来源 go/cmd/vtctldclient/command/query.go参数默认值说明--max-rows10000读取结果的最大行数注意它并不给查询附加 LIMIT只是限制从 MySQL 读入的行数--disable-binlogsfalse执行期间关闭 binary logging对应 MySQL 侧SET sql_log_bin OFF--reload-schemafalse执行后指示 tablet 重载 schema--json/-jfalse以 JSON 而非人读表格输出结果六、升级迁移建议拆分多语句为单条执行将脚本中的多语句批次逐条调用ExecuteFetchAsDBA避免触发拒绝错误。schema 初始化脚本继续使用多语句只要批次中全部语句均为CREATE TABLE/CREATE VIEW旧有初始化模式不受影响。需要执行混合 DDL/DML 批次时改用ExecuteMultiFetchAsDBA该命令被设计为多语句专用入口返回多条QueryResult并额外支持会话变量注入与foreign_key_checks开关见 executeMultiFetchAsDba 的执行流程。注意ExecuteMultiFetchAsDBA从更晚的版本才开始提供使用前请确认集群版本支持。长期演进仓库当前代码的注释显示后续版本v23 起将彻底禁止ExecuteFetchAsDba的多语句用法多语句执行将完全收敛到ExecuteMultiFetchAsDba唯一入口见 rpc_query.go。v17 用户可借此变更提前改造脚本平滑过渡。七、结语ExecuteFetchAsDBA拒绝多语句 SQL 是一次典型的以破坏性变更换取确定性的工程决策它牺牲了旧行为的便利性换来了错误上报的完整性、连接池的洁净以及 schema 缓存的一致性。对 Vitess 集群运维者而言理解这一变更的边界非 CREATE 多语句拒绝、CREATE 序列放行、ExecuteMultiFetchAsDBA补位是顺利完成 v17.0.6 升级的关键。详见 changelog/17.0/17.0.6/release_notes.md。↩详见本仓库内完整 changelogchangelog/17.0/17.0.6/changelog.md对应 PR #14983 / #14954。↩ ↩赞分享数据库分布式数据库云原生后端数据存储【免费下载链接】vitessVitess is a database clustering system for horizontal scaling of MySQL.项目地址https://gitcode.com/gh_mirrors/vi/vitess点击查看免费下载相关推荐SvelteKit goto 破坏性变更解析调用不存在的路由时将拒绝导航SvelteKit goto 破坏性变更解析调用不存在的路由时将拒绝导航 本篇文章围绕 SvelteKit 仓库中的 changeset 文件 goto erWeb框架后端前端Vitess v18.0.3 版本全解析ExecuteFetchAsDBA 多语句加固与 47 项修复的实战指南Vitess v18.0.3 版本全解析ExecuteFetchAsDBA 多语句加固与 47 项修复的实战指南 v18.0.3 是 Vitess 18.0数据库分布式数据库云原生后端数据存储Vitess 15.0 升级指南破坏性变更、新特性与迁移实操全解析Vitess 15.0 升级指南破坏性变更、新特性与迁移实操全解析 本篇技术指南以 Vitess 15.0.0 官方 Release Summary 为主体骨数据库分布式数据库云原生后端数据存储创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
