无法将SSIS捕获的错误信息插入SQL自定义日志表问题咨询
SSIS包级OnError事件无法写入错误日志的排查与修复
你遇到的日志写入失败问题,90%以上是以下几个配置遗漏导致的,按优先级排查:
最高概率诱因:拼接SQL的语法错误
从你提供的表达式配置截图看,你是直接把System::ErrorDescription变量值拼接进INSERT语句,没有做单引号转义:
- 你触发的「列不能为空」类错误,系统返回的错误描述本身就会带单引号(比如
Column 'ColName' cannot be null),直接拼接后生成的SQL会出现引号不配对的语法错误,直接导致Execute SQL Task执行失败,自然不会有日志写入表中。
修复方式
不要用表达式拼接SQL,改用参数化查询:
- 选中OnError事件处理器里的Execute SQL Task,把
SQLSourceType设为DirectInput - 写入带参数占位符的SQL语句(SQL Server环境用
?作为占位符):
INSERT INTO dbo.YourCustomErrorLog(ErrorOccurTime, ErrorMsg, PackageName, TaskName) VALUES (GETDATE(), ?, ?, ?)
- 切到「Parameter Mapping」页,添加以下系统变量映射,对应参数顺序和占位符顺序保持一致,字符串类型参数长度设为
4000以上避免截断:System::ErrorDescription映射为NVARCHAR类型,对应第一个?System::PackageName映射为NVARCHAR类型,对应第二个?System::SourceName映射为NVARCHAR类型,对应第三个?
- 清空原来的SQL语句表达式配置,避免覆盖手动写的参数化SQL。
第二高频诱因:事件未正常冒泡到包级别
包级别的OnError事件依赖子层级的错误向上冒泡传递,以下配置会阻断事件传递:
- 检查数据流任务(你做Excel导入的那个Data Flow Task)有没有单独添加OnError事件处理器,如果有,选中该事件处理器作用域下的
System::Propagate系统变量,确认值为True。如果设为False,错误会被当前层级拦截,不会向上传递到包级事件处理器。 - 检查数据流任务、包本身的
MaximumErrorCount属性,不要设为0,默认值1即可,避免错误触发后直接终止包运行,没等事件处理器执行完就退出。
第三类易漏配置
- 把OnError事件处理器里的Execute SQL Task的
DelayValidation属性设为True,避免包启动验证阶段因为连接未初始化、变量值为空导致验证失败,事件处理器任务被阻塞无法执行。 - 把事件处理器内所有任务的
FailPackageOnFailure、FailParentOnFailure属性设为False,就算日志写入本身出问题,也不会阻断原有错误流程,也方便排查日志任务本身的执行错误。 - 确认Execute SQL Task绑定的连接管理器账号,对目标错误日志表有INSERT权限,不要用权限不足的账号连库。
快速验证步骤
- 先手动给
System::ErrorDescription赋一个不带特殊字符的测试值,单独执行事件处理器里的Execute SQL Task,确认能正常写入日志表,排除连接、表权限类问题。 - 在事件处理器开头加一个脚本任务,弹窗输出
System::ErrorDescription的实时值,执行完整包:如果没有弹窗,说明事件冒泡配置有问题;如果有弹窗但没写入日志,回到第一点检查SQL配置。
相关配置参考截图:
- 包配置截图
- OnError事件处理器配置截图
- 表达式配置截图
内容的提问来源于stack exchange,提问作者Jeff
相关产品推荐
相关产品推荐




