SQL Server Agent作业调用OPENROWSET读xlsx返回0条无报错

云原生阿岚

2026-8-30

问题诱因分析

核心原因是Microsoft.ACE.OLEDB.12.0属于Office桌面类组件，并非原生为服务端无交互场景设计，在SQL Agent运行的会话0（非交互式会话）下，强依赖用户配置文件的注册表项、系统预设Desktop目录的读写权限；内置服务账号NT SERVICE\SQLSERVERAGENT默认不会加载完整的用户配置文件，且对应路径下的Desktop目录默认不存在，驱动初始化异常时不会抛出显性错误，只会静默返回空结果集，因此作业日志不会记录任何报错。
Office 365即点即用（Click-to-Run）版本的ACE驱动默认做了COM会话隔离，内置服务账号没有Excel COM组件的本地启动、激活权限，驱动无权限时不会抛出异常，直接返回空数据集。
从其他设备上传/拷贝到服务器的xlsx文件默认会带NTFS备用数据流标记（标记为外部来源不受信任文件），交互式场景下打开会弹出受保护视图提示，但非交互式会话下没有弹窗界面，驱动会直接拦截文件读取返回空结果。
ACE驱动默认仅扫描前8行数据判定列类型，如果前几行存在数据类型混杂的情况，可能把[Carrier NAME]列判定为非文本类型，导致后续行的文本值被读取为NULL，最终被WHERE [Carrier NAME] IS NOT NULL条件过滤为0条结果；手动执行时如果文件刚被桌面程序打开过，驱动会复用缓存的表结构元数据，不会触发类型误判。
每分钟调度的作业存在时间窗口冲突：文件上传进程还未完成xlsx写入、释放文件锁时作业就触发读取，ACE驱动遇到被锁定的xlsx文件时不会报文件占用错误，会直接返回空结果。
处理txt、pdf等文件无异常，是因为这类文件的读取逻辑不依赖Office ACE组件，不存在会话0下的桌面组件兼容问题；手动分步执行时使用当前登录用户的交互式会话，有完整的用户配置文件和权限，因此可以正常读取数据。

排查修复方案

补全ACE驱动依赖的系统目录：根据SQL实例位数创建缺失的Desktop目录，64位实例创建路径C:\Windows\System32\config\systemprofile\Desktop，32位实例运行在64位系统上时创建路径C:\Windows\SysWOW64\config\systemprofile\Desktop，给NT SERVICE\SQLSERVERAGENT和对应SQL数据库引擎服务账号（默认是NT SERVICE\MSSQLSERVER，命名实例对应调整）授予两个目录的读、写、修改权限，无需重启服务即可生效。
配置Excel COM组件权限：运行dcomcnfg打开组件服务，若安装的是32位Office则运行comexp.msc /32打开32位组件服务，找到【组件服务-计算机-我的电脑-DCOM配置-Microsoft Excel Application】项，打开属性页：
- 切到「安全」标签，在启动和激活权限、访问权限配置项中，添加NT SERVICE\SQLSERVERAGENT账号，授予本地启动、本地激活、本地访问权限
- 切到「标识」标签，选择「启动用户」，保存配置

增加文件前置校验逻辑：在作业步骤读取xlsx文件前，增加10-30秒的等待重试逻辑，确认文件未被其他进程锁定后再执行读取；同时执行命令清除文件的外部来源标记，避免受保护视图拦截，示例逻辑：

$filePath = "F:\Clients\ClientName\TPA\20220609\FileName.xlsx"
# 等待文件释放锁，最多等待30秒
for($i=0;$i -lt 30;$i++){
    try{
        [IO.File]::OpenWrite($filePath).Close()
        break
    }catch{
        Start-Sleep -Seconds 1
    }
}
# 清除外部文件阻止标记
Unblock-File -Path $filePath

优化ACE连接串参数：在OPENROWSET的Excel连接串中增加IMEX=1;MaxScanRows=0配置，修改后连接串为Excel 12.0;HDR=YES;IMEX=1;MaxScanRows=0;Database=F:\Clients\ClientName\TPA\20220609\FileName.xlsx，强制驱动以混合类型模式读取数据、扫描全量行判定列类型，避免列类型误判导致有效数据被过滤。
替换服务运行账号（上述方案无效时使用）：将SQL Server Agent服务的运行账号从内置的NT SERVICE\SQLSERVERAGENT替换为服务器本地的实体管理员账号（需提前登录过一次服务器，生成完整的用户配置文件），给该账号授予xlsx文件存储目录的读写权限、SQL实例内对应作业所需的最小权限，重启Agent服务即可。该方案可以彻底规避内置服务账号配置文件不完整导致的ACE驱动兼容问题。
增加底层错误捕获：不要完全依赖SQL Agent默认作业日志，在读取逻辑外层加TRY...CATCH块，同时在查询前后抓取sys.dm_os_ring_buffers中OLEDB驱动相关的错误记录，写入自建的作业日志表，避免驱动静默返回空结果时无日志可查。

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