SqlSugar 批量删除数据时处理参数过多的解决方案

在使用 SqlSugar 进行数据库操作时，开发者经常会遇到需要批量删除数据的情况。当使用 Deleteable 方法配合 WhereColumns 进行无主键删除操作时，如果数据量较大，可能会遇到"too many parameters"的错误。本文将深入分析这个问题，并提供几种有效的解决方案。

问题分析

在 SqlSugar 中，当我们使用以下代码进行批量删除时：

var dcs = _sqlSugarClient.Utilities.DataTableToDictionaryList(dt);
var total = await _sqlSugarClient.Deleteable<object>()
    .AS(fullTableName)
    .WhereColumns(dcs)
    .ExecuteCommandAsync();

如果 dcs 包含的数据量很大，就会导致生成的 SQL 语句包含过多的参数，超出数据库系统允许的参数数量限制，从而抛出"too many parameters"异常。这是因为每个字典项都会转换为 SQL 参数，当数据量大时，参数数量会迅速增加。

解决方案

1. 使用分页批量处理

SqlSugar 提供了 Utilities.PageEachAsync 方法，可以方便地对大数据集进行分页处理：

await db.Utilities.PageEachAsync(allList, 100, async pageList => {
    await _sqlSugarClient.Deleteable<object>()
        .AS(fullTableName)
        .WhereColumns(pageList)
        .ExecuteCommandAsync();
});

这种方法将大数据集分割成每页100条记录的小批次进行处理，有效避免了单次操作参数过多的问题。

2. 使用实体操作的 PageSize 方法

如果是针对实体类的删除操作，SqlSugar 提供了更简便的 PageSize 方法：

await _sqlSugarClient.Deleteable<Entity>()
    .Where(/*条件*/)
    .PageSize(100) // 每批次处理100条
    .ExecuteCommandAsync();

这种方法会自动将删除操作分批执行，开发者无需手动处理分页逻辑。

3. 使用原生 SQL 批量删除

对于特别大的数据集，可以考虑使用原生 SQL 语句进行批量删除：

var ids = string.Join(",", dcs.Select(d => d["Id"]));
await _sqlSugarClient.Ado.ExecuteCommandAsync(
    $"DELETE FROM {fullTableName} WHERE Id IN ({ids})");

但需要注意 SQL 注入风险和 SQL 语句长度限制。

最佳实践建议

1. 合理设置批次大小：根据数据库性能和应用需求，调整每批次处理的数据量，通常在100-1000条之间。

2. 事务处理：如果业务需要保证原子性，可以在外层添加事务：

await _sqlSugarClient.Ado.UseTranAsync(async () => {
    await db.Utilities.PageEachAsync(allList, 100, async pageList => {
        await _sqlSugarClient.Deleteable<object>()
            .AS(fullTableName)
            .WhereColumns(pageList)
            .ExecuteCommandAsync();
    });
});

3. 性能监控：对于大数据量删除操作，建议添加日志记录执行时间和影响行数，便于性能优化。

4. 考虑使用临时表：对于极其复杂的批量删除场景，可以考虑先将需要删除的ID存入临时表，然后通过表连接进行删除。

通过以上方法，开发者可以有效地解决 SqlSugar 批量删除操作中参数过多的问题，同时保证操作的性能和可靠性。