mysql_insert函数

函数名：mysql_insert / mysql_insert

功能描述

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

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

语法

=mysql_insert(表名, 字段值对, [连接字符串])

参数

参数名	类型	必填	默认值	说明
表名	String	是	-	要插入数据的表名称
字段值对	String	是	-	字段与值对应关系，格式：字段1=值1,字段2=值2，多对用逗号分隔
连接字符串	String	否	""	MySQL 连接字符串；为空时使用已保存的默认连接

返回值

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

使用示例

单条数据插入

公式：

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

结果：

插入成功，影响 1 行

自定义连接字符串插入

公式：

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

结果：

插入成功，影响 1 行

无效字段格式

公式：

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

结果：

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

技术说明

• 按 , 分割字段值对，再按 = 拆分字段名与值，生成 INSERT INTO <表名> (字段...) VALUES (@字段...) 语句。
• 采用参数化查询（MySqlParameter）传递值，有效防止 SQL 注入风险。
• 连接字符串 为空时回退到全局默认连接 connStr；经 build_connectstring 处理默认超时与 SSL 模式。
• 本函数为同步执行，无 "Waiting..." 中间态。

错误处理

错误场景	返回值
未提供有效的字段值对	错误: 未提供有效的字段值对
字段/值不匹配或不存在	插入错误: <异常信息>
连接字符串无效/连接失败	插入错误: <异常信息>