如何高效向MariaDB插入数据？两种方案对比及最佳实践

本质差异 #

两种实现的核心区别在于数据库交互的方式和开销，具体体现在这几个方面：

• 网络与数据库开销
  循环调用conn.query()时，每一次插入都是独立的网络请求，数据库需要重复解析SQL语句、创建执行计划——哪怕SQL模板完全一致。数据量越大，这种重复开销的累积越明显，会直接拉高接口响应时间。
  而batch()方法是将所有插入数据打包成一次网络请求发送，数据库只需要解析一次SQL模板，批量执行插入操作，能大幅减少网络往返次数和数据库的重复计算开销。

• 事务一致性的实现成本
  如果需要保证所有插入操作的原子性（要么全成功，要么全失败），循环插入需要手动在外部包裹事务，且中间某一次插入失败时，要额外处理回滚逻辑，代码冗余度高。
  batch()本身基于预处理语句批量执行，配合事务使用时，只需要一次beginTransaction和commit就能保证原子性，逻辑更简洁，出错概率更低。

• 性能表现
  数据量小的时候（比如1-2条），两种方式差异几乎可以忽略，但当插入数据量≥10条时，batch()的性能优势会呈指数级放大。比如插入1000条数据，循环插入可能需要几百毫秒甚至数秒，而批量插入通常只需要几十毫秒。

最佳实践 #

毫无疑问，batch()是这类场景的最佳实践，理由如下：

1. 性能优势显著，尤其在批量数据插入场景下，能大幅降低接口延迟和数据库负载。
2. 代码更简洁，事务控制更方便，减少出错概率。
3. 即使数据量极小，使用batch()也不会带来额外开销，反而能统一代码风格。

注意事项

• 确保所有待插入数据的结构与SQL模板的参数匹配，避免因参数不统一导致的错误。
• 始终配合事务使用，保证批量插入的原子性，示例代码：

  const conn = await pool.getConnection();
  try {
    await conn.beginTransaction();
    // dataArray为转换后的参数数组，格式如[[val1, val2], [val3, val4], ...]
    await conn.batch('INSERT INTO your_table (col1, col2) VALUES (?, ?)', dataArray);
    await conn.commit();
  } catch (error) {
    await conn.rollback();
    throw error;
  } finally {
    conn.release();
  }
  

• 如果待插入数据量极大（比如上万条），需要分批次执行batch()，避免触发数据库的max_allowed_packet限制，建议每500-1000条为一个批次。

内容的提问来源于stack exchange，提问作者lia-ail