封装pyodbc连接为函数遇问题：导入报错与DLL加载失败

一、解决NameError: name 'sql_query' is not defined导入错误 #

检查以下核心点：

• 确认封装文件命名为environments.py，且与调用脚本在同一目录，或该目录已被添加到Python的sys.path中
• 打开environments.py，验证sql_query函数无拼写错误、无缩进问题（函数代码块需正确缩进），且未被嵌套在if __name__ == '__main__':这类仅本地执行的代码块内
• 导入语句必须正确：使用from environments import sql_query，避免模块名或函数名拼写错误
• 若封装文件在子目录中，需在子目录内添加空的__init__.py文件，再通过相对路径或完整模块路径导入

二、解决“DLL load failed while importing _multiarray_umath”错误 #

该错误由numpy模块加载失败导致（pandas依赖numpy），按以下步骤修复：

1. 重装兼容版本的numpy：卸载现有版本后指定兼容版本安装，命令如下：

   pip uninstall numpy -y
   pip install numpy==1.26.4  # 选择与你的Python版本匹配的版本，如Python3.10+适配1.26.x系列
   

2. 补充VC++运行库：安装对应版本的Microsoft Visual C++ Redistributable（如Python3.10+需2019版本），填补系统缺失的DLL文件
3. 重建虚拟环境：若使用虚拟环境，可能环境文件损坏，删除旧环境后重新创建并安装所有依赖
4. 验证版本兼容性：避免用过新的Python版本（如3.12）搭配过旧的numpy，可查看numpy官方文档确认兼容版本范围

三、优化pyodbc连接封装实现 #

以下是更健壮、易扩展的封装方案，支持多服务器配置，直接返回DataFrame：

1. 创建db_utils.py（替换原environments.py），代码如下：

import pyodbc
import pandas as pd

# 默认配置，可扩展多个环境的服务器信息
DEFAULT_CONFIG = {
    'driver': '{ODBC Driver 17 for SQL Server}',
    'server': 'your-default-server',
    'database': 'your-default-db',
    'trusted_connection': 'yes'  # Windows认证，SQL认证需添加'uid'和'pwd'字段
}

def sql_query(query, config=None):
    # 合并默认配置与用户自定义配置
    db_config = DEFAULT_CONFIG.copy()
    if config:
        db_config.update(config)
    
    # 用with语句自动管理连接生命周期，避免资源泄漏
    with pyodbc.connect(**db_config) as conn:
        try:
            df = pd.read_sql(query, conn)
            return df
        except pyodbc.Error as e:
            print(f"数据库查询错误: {e}")
            raise  # 抛出错误供调用者处理，也可返回空DataFrame

2. 调用示例：在其他脚本中直接导入即可，支持覆盖默认服务器：

from db_utils import sql_query

# 使用默认服务器执行查询
df_default = sql_query("SELECT * FROM your_table")

# 指定其他服务器执行查询
custom_config = {
    'server': 'another-server',
    'database': 'another-db'
}
df_custom = sql_query("SELECT * FROM another_table", config=custom_config)

该方案优势：

• 配置与逻辑分离，便于管理多服务器信息
• 自动处理连接的打开与关闭，避免资源泄漏
• 支持自定义配置，灵活适配不同环境
• 包含错误捕获，方便排查问题

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