mysql_update函数

函数名：mysql_update / mysql_update

功能描述

通过指定表名、更新字段值和筛选条件，安全执行 MySQL 数据更新操作，自动生成参数化的 UPDATE 语句，返回更新结果与影响行数。

会员等级：🟢 免费版（Free）

语法

=mysql_update(表名, 更新字段值对, [条件], [连接字符串])

参数

参数名	类型	必填	默认值	说明
表名	String	是	-	要更新的表名称
更新字段值对	String	是	-	要更新的字段和值，格式：字段1=新值1,字段2=新值2，多对用逗号分隔
条件	String	否	""	WHERE 条件，如 id=1；为空时拒绝执行并返回错误
连接字符串	String	否	""	MySQL 连接字符串；为空时使用已保存的默认连接

返回值

Object[,] - 二维数组（单格）。成功时返回 更新成功，影响 X 行；失败时返回错误信息。

使用示例

单字段更新

公式：

=mysql_update("user","age=26","id=1")

结果：

更新成功，影响 1 行

多字段批量更新

公式：

=mysql_update("user","name=李四,age=30","id=2")

结果：

更新成功，影响 1 行

自定义连接字符串更新

公式：

=mysql_update("product","price=4999","pro_id=1001","Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;SslMode=None;")

结果：

更新成功，影响 1 行

未指定 WHERE 条件

公式：

=mysql_update("user","age=20","")

结果：

错误: 更新操作必须指定WHERE条件

技术说明

• 强制要求指定 WHERE 条件，防止全表误更新。
• 按 , 分割字段值对，再按 = 拆分字段名与值，生成 UPDATE <表名> SET 字段=@set_字段... WHERE <条件> 语句。
• 采用参数化查询（MySqlParameter，参数名加 @set_ 前缀）传递值，有效防止 SQL 注入风险。
• 连接字符串 为空时回退到全局默认连接 connStr；经 build_connectstring 处理默认超时与 SSL 模式。
• 本函数为同步执行，无 "Waiting..." 中间态。

错误处理

错误场景	返回值
未指定 WHERE 条件	错误: 更新操作必须指定WHERE条件
未提供有效的更新字段	错误: 未提供有效的更新字段
字段/值不匹配或不存在	更新错误: <异常信息>
连接字符串无效/连接失败	更新错误: <异常信息>