mysql_delete函数

函数名：mysql_delete / mysql_delete

功能描述

根据指定条件安全执行 MySQL 数据表数据删除操作，强制要求 WHERE 筛选条件以避免全表数据丢失，返回删除结果与影响行数。

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

语法

=mysql_delete(表名, [条件], [连接字符串])

参数

参数名	类型	必填	默认值	说明
表名	String	是	-	要删除数据的表名称
条件	String	否	""	WHERE 条件，如 id=1；为空时拒绝执行并返回错误
连接字符串	String	否	""	MySQL 连接字符串。注意：本函数不自动使用已保存的默认连接，需传入有效连接字符串

返回值

Object[,] - 二维数组（单格）。成功时返回 删除成功，影响 X 行；无匹配数据时返回提示；失败时返回错误信息。

使用示例

单条数据删除

公式：

=mysql_delete("user","id=1","Server=127.0.0.1;Database=test;Uid=root;Pwd=123456;SslMode=None;")

结果：

删除成功，影响 1 行

条件匹配删除

公式：

=mysql_delete("user","age<18","Server=127.0.0.1;Database=test;Uid=root;Pwd=123456;SslMode=None;")

结果：

删除成功，影响 2 行

未指定 WHERE 条件

公式：

=mysql_delete("user","")

结果：

错误: 删除操作必须指定WHERE条件

无匹配数据

公式：

=mysql_delete("user","id=999","Server=127.0.0.1;Database=test;Uid=root;Pwd=123456;SslMode=None;")

结果：

未找到匹配的数据，删除0行

技术说明

• 强制要求指定 WHERE 条件，禁止全表删除操作。
• 自动生成 DELETE FROM <表名> WHERE <条件> 语句并执行。
• 使用 using 自动管理连接资源，保证连接安全释放。
• 注意：本函数直接使用传入的 连接字符串 创建连接，不会回退到全局默认连接 connStr，也不经 build_connectstring 处理默认超时与 SSL 模式，因此需传入完整有效的连接字符串。
• 本函数为同步执行，无 "Waiting..." 中间态。

错误处理

错误场景	返回值
未指定 WHERE 条件	错误: 删除操作必须指定WHERE条件
无匹配数据	未找到匹配的数据，删除0行
连接字符串无效/为空	删除错误: <异常信息>
表不存在或语法错误	删除错误: <异常信息>