Pyodbc执行SQL Server查询结果与直接执行不一致问题排查

先排查最可能的问题点 #

1. 临时表作用域的坑 #

SQL Server的本地临时表（#开头）仅在当前会话+当前批处理内有效。你在SSMS里用GO分隔批处理没问题，但pyodbc完全不识别GO——如果SQL里写了GO，要么直接触发语法错误，要么循环生成临时表的逻辑和后续查询不在同一个批处理，导致只能读到部分数据。

2. 循环变量未显式初始化 #

检查while循环用到的计数器、最大值这类变量，是不是没在SQL开头显式声明赋值？SSMS里可能会保留会话之前的变量值，但pyodbc每次都是全新会话，变量默认值不对的话，循环会提前终止，自然只插入32行数据。

3. 多结果集未处理 #

如果你的循环过程中每次执行都会返回结果（比如中间有SELECT语句），pyodbc默认只会读取第一个结果集，后面的循环逻辑相当于没执行完全，临时表的数据自然不全。必须手动跳过所有中间结果集，才能拿到最终的临时表数据。

4. 临时表生命周期的问题 #

要是你把循环生成临时表和查询临时表的语句拆分到了不同的execute调用里，第二个调用可能读不到第一个调用创建的临时表（尽管是同一个会话，但批处理隔离可能导致逻辑异常）。

具体修复步骤 #

1. 删掉SQL中的GO语句：pyodbc不支持该关键字，把所有逻辑合并成一个批处理，或者分多次调用execute执行（比如先执行循环生成临时表的部分，再执行查询部分）。
2. 手动处理多结果集：执行完SQL后，跳过所有中间结果集，示例代码：

cursor.execute(your_sql)
# 跳过所有中间产生的结果集
while cursor.nextset():
    pass
# 再读取最终数据
rows = cursor.fetchall()

3. 显式初始化循环变量：在SQL开头就声明并赋值所有用到的变量，比如：

DECLARE @Counter INT = 1;
DECLARE @MaxId INT;
SELECT @MaxId = MAX(Id) FROM 你的源表;

别依赖会话的默认值，避免不同环境下的行为差异。
4. 验证临时表行数：在SQL末尾加一句SELECT COUNT(*) FROM #ProfileData_DomainsOnly，分别在SSMS和pyodbc中执行，看返回的计数是否一致——如果pyodbc返回32，说明是循环生成数据的逻辑有问题；如果返回235，说明是读取数据时的结果集处理有问题。

完整示例代码 #

import pyodbc
import csv

# 建立数据库连接
conn = pyodbc.connect('DRIVER={ODBC Driver 17 for SQL Server};SERVER=你的服务器地址;DATABASE=目标数据库;UID=账号;PWD=密码')
cursor = conn.cursor()

# 整理后的SQL逻辑（无GO，显式初始化变量）
sql = """
DECLARE @Counter INT = 1
DECLARE @MaxId INT
SELECT @MaxId = MAX(Id) FROM 源表

CREATE TABLE #ProfileData_DomainsOnly (Id INT, Domain VARCHAR(255))

WHILE @Counter <= @MaxId
BEGIN
    -- 替换成你的循环插入逻辑
    INSERT INTO #ProfileData_DomainsOnly
    SELECT Id, Domain FROM 另一张表 WHERE Id = @Counter
    
    SET @Counter = @Counter + 1
END

SELECT * FROM #ProfileData_DomainsOnly
"""

cursor.execute(sql)

# 跳过中间结果集，确保读到最终的临时表数据
while cursor.nextset():
    pass

# 导出为CSV
with open('输出结果.csv', 'w', newline='', encoding='utf-8') as f:
    writer = csv.writer(f)
    # 写入表头
    writer.writerow([col[0] for col in cursor.description])
    # 写入数据行
    writer.writerows(cursor.fetchall())

conn.close()

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