灵析表格

Appearance

mysql_insert函数 ​

函数名：mysql_insert

函数功能 ​

通过简单的字段值配对参数，快速向MySQL数据表执行数据插入操作，自动生成安全的INSERT语句，返回插入结果与影响行数。

参数规范 ​

参数名类型必填示例特殊说明
tableNameString是"user"需填写MySQL数据库中存在的数据表名
fieldValuePairsString是"name=张三,age=25"字段与值对应关系，格式：字段1=值1,字段2=值2
connectionStringString否"Server=localhost;Database=test;Uid=root;Pwd=123456;"可选参数，为空时使用默认连接配置

使用案例 ​

单条数据插入 ​

问题描述：向user表插入姓名和年龄数据 公式演示：

excel
=mysql_insert("user","name=张三,age=25")

输出效果：

text
插入成功，影响 1 行

自定义连接字符串插入 ​

问题描述：连接指定数据库，向product表插入商品信息 公式演示：

excel
=mysql_insert("product","pro_name=笔记本,price=5999","Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;")

输出效果：

text
插入成功，影响 1 行

错误参数插入测试 ​

问题描述：使用无效字段格式测试插入，查看异常结果 公式演示：

excel
=mysql_insert("user","错误格式")

输出效果：

text
插入错误: 未提供有效的字段值对

技术说明 ​

插入规则 ​

  • 自动解析字段值对，生成标准INSERT语句
  • 采用参数化查询，有效防止SQL注入风险
  • 自动处理数据库连接，执行完成后安全关闭释放资源
  • 异步执行操作，等待过程中返回Waiting...

异常处理 ​

错误场景返回值
表名为空#N/A
无效字段值对错误: 未提供有效的字段值对
字段/值不匹配插入错误+异常信息
数据库连接失败插入错误+异常信息

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