Entity Framework Core 6对接PostgreSQL批量插入如何合并为单条INSERT语句

EF Core 配合 Npgsql 原生支持将多条插入合并为单条多VALUES的INSERT语句，你当前没有触发是默认批处理阈值的问题，按下面步骤配置即可：

1. 开启并配置批处理参数 #

在注册DbContext的代码中，调整Npgsql的批处理配置：

var builder = WebApplication.CreateBuilder(args);

// 注册DbContext时配置批处理
builder.Services.AddDbContext<你的DbContext类名>(options =>
    options.UseNpgsql(
        builder.Configuration.GetConnectionString("你的PG连接字符串配置名"),
        npgsqlOptions => {
            // 单次批处理允许的最大操作数，可根据你的业务场景调整，最大值不超过PG参数上限即可
            npgsqlOptions.MaxBatchSize(1000);
        })
        // 开发环境可开启日志和敏感数据日志，验证生成的SQL
        .LogTo(Console.WriteLine, LogLevel.Information)
        .EnableSensitiveDataLogging()
);

默认状态下，当单次SaveChangesAsync包含的插入操作≥4条时，EF Core会自动触发批处理，合并为单条INSERT INTO <表> (<列>) VALUES (<行1>),(<行2>),...格式的SQL。

2. 调整最小批处理阈值（可选） #

如果你希望更少的插入条数就触发批处理，可以手动修改最小阈值：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseNpgsql("你的连接字符串")
        // 最小批处理阈值设为1，即只要≥2条插入就触发批处理
        .MinBatchSize(1);
}

注意事项 #

• 表的自增主键（Serial/Identity类型）不会影响批处理逻辑，EF Core会自动返回所有插入行的主键值
• 当插入操作的总参数数量超过PostgreSQL默认的65535参数上限时，EF Core会自动拆分多个批处理，不会出现报错
• 没有特殊需求不需要引入第三方批量插入扩展，Npgsql原生批处理的兼容性和性能已经满足绝大多数场景

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