DbUp多变量循环脚本实现：IScript无法获取.WithVariable()传参咨询

针对自定义IScript实现中无法读取.WithVariable()传入变量的问题，可落地的实现方案如下：

方案1：通过构造函数注入打通自定义脚本的变量访问通道 #

• 出现访问不到变量的核心原因是，默认流程下DbUp只会对嵌入资源里的SQL脚本做变量替换，不会主动把全局变量上下文传给你自己写的IScript实现类。只要在实例化自定义脚本对象时，主动把已经配置好的全局变量集合通过构造函数传进去，就能完全访问所有通过.WithVariable()配置的参数值
• 示例实现代码：

/// <summary>
/// 自定义批量执行脚本
/// </summary>
public class BatchUpdateScript : IScript
{
    private readonly IReadOnlyDictionary<string, string> _globalVariables;
    private readonly IEnumerable<int> _targetIdList;
    // 最终执行的脚本内容由遍历逻辑生成
    public string Script => BuildScriptContent();
    // 实例化时直接传入全局变量和待遍历的ID集合
    public BatchUpdateScript(IReadOnlyDictionary<string, string> globalVariables, IEnumerable<int> targetIdList)
    {
        _globalVariables = globalVariables;
        _targetIdList = targetIdList;
    }
    private string BuildScriptContent()
    {
        var scriptContent = new StringBuilder();
        // 遍历ID列表，用同一查询模板拼接不同参数值的执行语句
        foreach (var id in _targetIdList)
        {
            // 直接读取WithVariable传入的全局变量值
            var targetStatus = _globalVariables["TargetStatus"];
            scriptContent.AppendLine($"UPDATE TableA SET Status = {targetStatus} WHERE Id = {id};");
        }
        return scriptContent.ToString();
    }
}

• 注册脚本时，不要使用DbUp默认的无参构造注册逻辑，而是在构建升级器的流程中，先拿到已经配置完成的全局变量字典，再手动实例化上述自定义脚本类加入执行序列

方案2：依托DbUp原生变量机制，在SQL层实现批量逻辑 #

• 如果不需要在C#层做复杂的循环判断，完全可以把待遍历的ID列表提前处理成SQL可直接使用的文本值，通过.WithVariable()传入，无需自定义IScript实现，维护成本最低
• 变量配置示例：

var migrationIdList = new List<int> {101,102,103,104};
// 把ID列表拼接成IN查询可用的文本
var idInClause = string.Join(",", migrationIdList);
var upgrader = DeployChanges.To
    .SqlDatabase(connectionString)
    // 传入全局变量
    .WithVariable("IdValueList", idInClause)
    .WithVariable("TargetStatusValue", "2")
    .WithScriptsEmbeddedInAssembly(Assembly.GetExecutingAssembly())
    .Build();

• 对应迁移SQL脚本直接使用DbUp内置的变量占位符，由DbUp自动完成文本替换：

-- 执行时自动替换为实际的变量值
UPDATE TableA 
SET Status = ${TargetStatusValue} 
WHERE Id IN (${IdValueList});

• 这种方式完全走DbUp原生的变量管道，不存在变量访问不到的问题

方案3：挂载执行钩子实现批量逻辑 #

• 对需要在迁移流程中嵌入的批处理逻辑，可以通过DbUp的管道配置挂载自定义执行钩子，钩子对象初始化时即可直接获取全局变量配置
• 钩子逻辑可以在常规SQL脚本执行的前后，遍历ID列表通过参数化查询执行目标SQL，既不干扰原有脚本的执行顺序，也不需要通过IScript接口传递变量

实操注意事项 #

• 不要尝试从DbUp内部静态上下文读取变量，不同版本的内部实现没有向前兼容保证，升级版本后极易出现变量读空的问题
• 当待遍历的ID列表规模超过千级时，优先使用ADO.NET参数化绑定执行批量查询，不要逐行拼接单条SQL语句，避免生成的迁移脚本过长、执行效率过低
• 自定义的批量执行逻辑要纳入DbUp的事务管控范围，确保批处理操作和其他迁移脚本保持事务一致性，不会出现部分执行成功的问题

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