如何配置SQLAlchemy读取SQL Server BIT列时不将1/0转为True/False

问题根因 #

pyodbc驱动默认将SQL Server的BIT类型映射为Python原生布尔值，pandas读取后会将对应列识别为bool类型，导出CSV时自动输出True/False而非原始的1/0值。逐表逐列修改字段类型的方案维护成本高，不适配数百张表的批量处理场景。

全局生效方案（无需单表配置，兼容所有表） #

优先选择驱动层/连接层全局拦截的方案，从数据读取源头阻断BIT类型到布尔值的自动转换，所有通过该连接读取的表都会自动保留1/0整数值。

方案1：添加SQLAlchemy全局类型转换器（兼容性最好，支持所有ODBC驱动版本） #

只需要在创建数据库连接前添加一次全局事件监听，所有查询返回的BIT类型值会被自动转换为整数，无需修改任何单表读取逻辑，代码修改量极小。
修改后的完整可运行代码如下：

import pandas as pd
from sqlalchemy import create_engine, event
from sqlalchemy.engine import Engine
import pyodbc

# 全局注册BIT类型转换器，所有连接读取BIT值时直接返回整数1/0，不转布尔
@event.listens_for(Engine, "connect")
def convert_bit_to_int(dbapi_conn, _):
    cursor = dbapi_conn.cursor()
    # 绑定BIT类型的输出转换规则：空值返回None，非空值转整数
    dbapi_conn.add_output_converter(
        pyodbc.SQL_BIT,
        lambda val: int.from_bytes(val, byteorder="little") if val is not None else None
    )
    cursor.close()

pd.set_option('display.max_columns', None)
pd.set_option('max_colwidth', None)

# 读取待导出的表名清单
df = pd.read_csv(r'C:\Users\username\Downloads\py_tma_tables.csv')
tma_table = df['table_name'].tolist()

servername = 'SERVER'
dbname = 'DATABASE'
# 初始化数据库连接，原有连接逻辑无需改动
sqlcon = create_engine(
    f'mssql+pyodbc://@{servername}/{dbname}?driver=ODBC+Driver+17+for+SQL+Server'
)

# 批量导出所有表
for table_name in tma_table:
    df_data = pd.read_sql_query(f"SELECT * FROM {table_name}", sqlcon)
    # 此时原BIT类型列已自动为int类型，导出CSV直接写入1/0
    df_data.to_csv(f"{table_name}.csv", index=False, header=None, encoding='utf-8')

方案2：连接串加参数（仅适用于高版本ODBC驱动） #

如果本地安装的是ODBC Driver 17.4及以上、18.x版本，可以直接在连接字符串中添加ConvertBitToBoolean=No参数，驱动层直接关闭BIT到布尔的自动转换，代码更简洁：

sqlcon = create_engine(
    f'mssql+pyodbc://@{servername}/{dbname}?driver=ODBC+Driver+18+for+SQL+Server&ConvertBitToBoolean=No'
)

注意：低版本ODBC驱动不识别该参数，连接时会抛出异常，生产环境优先使用方案1保证兼容性。

效果验证 #

读取表后打印字段类型，可以看到原BIT类型的字段（如示例中的cst_active、cst_splitBill、cst_subContract、cst_header）dtype会从bool变为int64，导出的CSV文件中对应字段直接存储1、0数值，无任何True/False值，全程无需针对单表做定制处理，可直接跑全量450张表的导出任务。

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