PowerShell中Invoke-Sqlcmd查询结果与SSMS不一致问题排查

针对PowerShell脚本返回行数与SSMS不一致的问题，可按以下步骤逐一排查：

1. 对齐SQL执行环境的SET选项 #

SSMS与Invoke-Sqlcmd默认的SQL SET选项可能存在差异（如ANSI_NULLS、QUOTED_IDENTIFIER等），这会直接影响LIKE、JOIN等逻辑的执行结果。在查询开头添加SSMS默认的SET选项，确保执行环境一致：

SET ANSI_NULLS ON;
SET QUOTED_IDENTIFIER ON;
SET CONCAT_NULL_YIELDS_NULL ON;
SET ANSI_WARNINGS ON;
SET ANSI_PADDING ON;

-- 原查询内容
SELECT
    document_dets.client_ref,
    document_dets.matter_suffix,
    archive.dept_code,
    document_dets.description,
    document_dets.doc_date,
    document_dets.file_name
FROM 
    document_dets
LEFT JOIN 
    archive 
ON archive.client_ref = document_dets.client_ref 
AND archive.matter_suffix = document_dets.matter_suffix 
WHERE
    doc_date >= Convert(datetime, '2023-05-01')
AND
    document_dets.description NOT LIKE 'NAP_%'
AND
    archive.file_status IN ('O', 'R')

2. 验证PowerShell中结果的实际过滤情况 #

直接在PowerShell中检查是否存在未被过滤的NAP_前缀记录，确认NOT LIKE条件是否真的未生效：

# 输出前10条疑似未过滤的记录
$SQLResults | Where-Object { $_.description -like 'NAP_%' } | Select-Object description, file_name -First 10

同时，在SQL查询中使用Unicode前缀N'NAP_%'避免字符编码问题：

document_dets.description NOT LIKE N'NAP_%'

3. 修正LEFT JOIN与WHERE条件的逻辑冲突 #

你的查询使用LEFT JOIN archive后，在WHERE子句中添加archive.file_status IN ('O', 'R')，这会将LEFT JOIN自动转为INNER JOIN（过滤掉archive表无匹配的行）。若这不是预期逻辑，将archive的条件移至JOIN的ON子句中：

LEFT JOIN 
    archive 
ON archive.client_ref = document_dets.client_ref 
AND archive.matter_suffix = document_dets.matter_suffix
AND archive.file_status IN ('O', 'R') -- 移至此处
WHERE
    doc_date >= Convert(datetime, '2023-05-01')
AND
    document_dets.description NOT LIKE 'NAP_%'

对比调整后SSMS与PowerShell的结果行数，确认是否因逻辑差异导致计数不同。

4. 确认查询语句未被篡改 #

PowerShell的多行字符串可能因格式问题被截断或修改，直接输出$query变量验证与SSMS中的查询完全一致：

Write-Host $query

5. 导出结果直接对比 #

将PowerShell和SSMS的查询结果导出为CSV，逐行对比差异，定位多出来的记录特征：

# PowerShell导出结果
$SQLResults | Export-Csv -Path "PS_Query_Results.csv" -NoTypeInformation

在SSMS中执行查询后，通过「结果到文件」导出为SSMS_Query_Results.csv，对比两个文件的行数和内容。

6. 检查模块版本与执行权限 #

确认PowerShell中SqlServer模块的版本，与SSMS使用的SQL客户端版本是否一致，不同版本可能存在行为差异：

Get-Module SqlServer -ListAvailable

同时验证PowerShell脚本的执行账号与SSMS登录账号是否拥有相同的数据访问权限，排除因权限导致的结果差异。

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