在SQL Server 2017中运行含主函数的Python文件并捕获错误

我来帮你搞定这个问题！既然你已经启用了SQL Server的Python查询功能，那接下来要运行带依赖模块的主脚本并捕获错误，只要按下面几步操作就行：

1. 先把文件和权限搞定 #

首先，你得把主Python文件（比如main_script.py）和所有它依赖的模块文件，放到SQL Server能访问到的文件夹里——比如我一般用C:\SQL_Python_Scripts\这种自定义路径。这里要注意：SQL Server的Launchpad服务（负责跑Python/R脚本的那个）默认用的是NT Service\MSSQLLaunchpad账户，你必须给这个账户分配该文件夹的读取和执行权限，不然会报权限错误。

另外，模块的文件夹结构要和你本地运行时一致！比如主脚本调用utils/helper.py里的方法，那就要保持C:\SQL_Python_Scripts\utils\helper.py这个结构，不能乱改路径。

2. 用sp_execute_external_script跑脚本+捕获错误 #

SQL Server里跑Python脚本全靠sp_execute_external_script这个存储过程。要捕获并打印错误，你可以在Python代码里加try-except块，同时把错误信息输出到SQL的消息窗口或者结果集里。

直接能用的示例代码 #

EXEC sp_execute_external_script
    @language = N'Python',
    @script = N'
import sys
import traceback

# 关键！把脚本所在路径加到Python的模块搜索路径里，不然找不到你的依赖模块
script_folder = r''C:\SQL_Python_Scripts''
sys.path.append(script_folder)

try:
    # 导入主脚本的主函数并执行
    from main_script import main
    main()
    # 执行成功的提示
    print("✅ 脚本运行成功！")
except Exception as e:
    # 捕获所有错误，打印详细信息（包括堆栈跟踪，方便定位问题）
    error_details = traceback.format_exc()
    print(f"❌ 运行出错：\n{error_details}")
    # 把错误信息输出到SQL结果集，方便查看和后续处理
    import pandas as pd
    error_df = pd.DataFrame({
        "错误类型": [type(e).__name__],
        "错误信息": [str(e)],
        "详细堆栈": [error_details]
    })
    OutputDataSet = error_df
',
    @input_data_1 = N''; -- 不需要输入数据就留空

3. 几个必须注意的点 #

• 模块路径一定要加：SQL Server的Python环境默认搜索路径不包含你的自定义文件夹，不加sys.path.append肯定会报ModuleNotFoundError，这个是新手最容易踩的坑！
• 权限问题别忽略：如果遇到“Permission denied”或者找不到文件的错误，先去检查MSSQLLaunchpad账户对脚本文件夹的权限，实在不行可以右键文件夹→属性→安全→添加这个账户，给它读取和执行权限。
• 错误信息要详细：用traceback模块打印堆栈跟踪比只打印str(e)有用多了，能直接看到错误出在哪个文件的哪一行，调试起来省超多时间。
• 先单独测模块：如果运行时报错，先写个简单的测试脚本，比如只导入某个依赖模块，看看能不能正常运行，排除模块本身的问题。

4. 看结果的地方 #

• 执行SQL后，SQL Server的消息窗口会显示Python的print输出（包括成功提示和错误堆栈）。
• 如果在except块里设置了OutputDataSet，你还能在结果窗口看到错误信息的表格，方便你导出或者进一步处理。

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