如何使用MySQL2在Node.js中实现SQL批量插入？

我有一组需要插入SQL的数据数组：

let arr = [
  {name:"john", age:8, country:"america"},
  {name:"jack", age:9, country:"england"},
  {name:"bob", age:12, country:"france"},
  {name:"lance", age:6, country:"spain"}
]

我正在Node.js中使用MySQL2库，当前的实现方式如下：

const transfer = async() => {
  for(person of arr){
    let sql = `INSERT INTO users(name, age, country) VALUES("${person.name}", ${person.age}, "${person.country}")`;
    const [res, _] = await db.execute(sql);
  }
}

该方式可正常运行，但我想知道是否有办法将数组arr中的所有对象通过一次SQL查询完成插入（而非每次插入执行一次查询）？

当然可以，MySQL本身支持批量插入语法，结合MySQL2的参数化查询（还能避免SQL注入），就能一次性完成所有数据的插入，具体实现如下：

步骤1：构造批量插入的SQL模板 #

MySQL批量插入的语法格式是：

INSERT INTO users(name, age, country) VALUES (?, ?, ?), (?, ?, ?), ...

我们可以根据数据数组的长度，自动生成对应的占位符分组。

步骤2：提取数据值并执行查询 #

把数组里每个对象的字段值提取成一个一维数组，再配合生成的SQL模板执行一次性插入。

完整代码示例：

const transfer = async() => {
  // 生成对应数量的占位符组，每个对象对应一组(?, ?, ?)
  const placeholders = arr.map(() => '(?, ?, ?)').join(',');
  // 把所有对象的字段值平铺成一维数组，匹配占位符顺序
  const values = arr.flatMap(person => [person.name, person.age, person.country]);
  // 构造完整的SQL语句
  const sql = `INSERT INTO users(name, age, country) VALUES ${placeholders}`;
  // 执行批量插入
  const [res, _] = await db.execute(sql, values);
  console.log(`成功插入 ${res.affectedRows} 条数据`);
}

优势说明 #

• 性能提升：减少了和数据库的网络交互次数，数据量越大，性能提升越明显
• 安全性高：用参数化查询的占位符替代字符串拼接，从根源避免SQL注入风险
• 原子性保障：单条INSERT语句默认是原子操作，要么全部插入成功，要么全部失败（如果需要支持部分成功，可以结合事务调整）

内容的提问来源于stack exchange，提问作者Aidenhsy