mysql_delete函数

函数名：mysql_delete

函数功能

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

参数规范

参数名	类型	必填	示例	特殊说明
tableName	String	是	"user"	需填写MySQL数据库中存在的数据表名
whereCondition	String	是	"id=1"	删除筛选条件，不允许为空
connectionString	String	否	"Server=localhost;Database=test;Uid=root;Pwd=123456;"	可选参数，为空时使用默认连接配置

使用案例

单条数据删除

问题描述：删除user表中指定id的用户数据 公式演示：

=mysql_delete("user","id=1")

输出效果：

删除成功，影响 1 行

条件匹配删除

问题描述：删除年龄小于18岁的用户数据 公式演示：

=mysql_delete("user","age<18")

输出效果：

删除成功，影响 2 行

无条件删除测试

问题描述：不指定WHERE条件执行删除，查看异常结果 公式演示：

=mysql_delete("user","")

输出效果：

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

无匹配数据删除

问题描述：条件无匹配数据时执行删除操作 公式演示：

=mysql_delete("user","id=999")

输出效果：

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

技术说明

删除规则

• 强制要求指定WHERE条件，禁止全表删除操作
• 自动生成标准DELETE SQL语句，操作简洁
• 采用资源自动释放机制，保证数据库连接安全
• 异步执行删除操作，等待过程中返回Waiting...

异常处理

错误场景	返回值
表名为空	#N/A
未指定WHERE条件	错误: 删除操作必须指定WHERE条件
无匹配数据	未找到匹配的数据，删除0行
数据库连接/语法错误	删除错误+异常信息

扩展应用

结合单元格条件删除

=mysql_delete("product",A1)  // A1单元格存储删除条件，快速清理数据

过期数据清理

=mysql_delete("orders","create_time<'2024-01-01'")

注：本函数为免费功能，在WPS 2019+和Excel 365中测试通过