mysql_insert函数
函数名：mysql_insert / mysql_insert
函数功能
向MySQL数据库表中插入数据，支持字段值对格式的参数化插入操作
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
tableName | String | 是 | "users" | 要插入数据的表名称 |
fieldValuePairs | String | 是 | "name=张三,age=25" | 字段和值的对应关系 |
connectionString | String | 否 | "server=localhost;" | MySQL连接字符串 |
使用案例
单条数据插入
问题描述：向用户表插入新用户数据
公式演示：
excel
=mysql_insert("users", "name=张三,age=25,email=zhang@example.com", "server=localhost;")输出效果：
text
插入成功，影响 1 行多字段数据插入
问题描述：插入包含多个字段的完整记录
公式演示：
excel
=mysql_insert("orders", "product_id=1001,quantity=5,price=299.9,order_date=2023-12-01")输出效果：返回插入成功的行数信息
技术说明
插入机制
- 自动解析字段值对格式参数
- 使用参数化查询防止SQL注入
- 支持动态字段列表插入
参数格式
字段值对采用标准格式：字段名=值，多个字段用逗号分隔
- 文本值：
name=张三 - 数字值：
age=25 - 日期值：
date=2023-12-01
异常处理
| 错误场景 | 返回值 |
|---|---|
| 字段不存在 | 插入错误信息 |
| 数据类型不匹配 | 类型转换错误 |
| 主键冲突 | 唯一约束违反提示 |
扩展应用
批量数据导入
excel
=mysql_insert("products", "name=手机,price=1999,category=电子")
=mysql_insert("products", "name=电脑,price=5999,category=电子")动态数据插入
excel
=mysql_insert("logs", "user=" & B2 & ",action=" & C2 & ",time=" & TEXT(NOW(),"yyyy-mm-dd"))注：本函数需要MySQL数据库连接支持，在WPS 2019+和Excel 365中测试通过