Airflow新增连接时缺失Microsoft SQL Server连接类型问题咨询

• 包安装环境与Airflow运行环境不匹配：MsSqlOperator能正常调用仅代表当前执行代码的Python环境中存在对应包，若Airflow Webserver、Scheduler运行在独立虚拟环境、容器环境或其他Python环境下，服务进程无法加载到你安装的提供程序，自然不会在前端显示对应连接类型。
• 服务未重启：Airflow在Webserver启动时才会扫描已安装的提供程序、注册对应连接类型，安装完提供程序包后不重启服务，前端不会加载新的选项。
• 提供程序版本与Airflow核心版本不兼容：跨大版本安装的MSSQL提供程序可能无法正常完成连接类型的钩子注册，仅算子类本身可以被Python导入，前端配置入口不会被识别。
• 缓存未更新：Airflow会缓存已扫描到的提供程序列表，旧缓存未失效时不会识别新安装的包。

按优先级依次操作即可：

1. 校验提供程序是否被Airflow正确识别
   切到Airflow服务实际运行的环境（如果是容器部署则进入容器终端，虚拟环境部署则激活对应虚拟环境），执行以下命令：

   airflow providers list | grep mssql
   

   如果输出为空，说明当前Airflow运行环境没有正确安装MSSQL提供程序，直接在该环境下重新执行安装命令即可：

   pip install apache-airflow-providers-microsoft-mssql
   

2. 全量重启Airflow服务
   确认提供程序被Airflow CLI识别后，重启所有Airflow组件，不要仅重启Webserver：

   # 原生部署参考命令
   pkill -f "airflow webserver"
   pkill -f "airflow scheduler"
   airflow scheduler -D
   airflow webserver -D
   

   Docker部署直接重启对应Stack/容器即可。重启完成后按Ctrl+F5强制刷新浏览器缓存，再进入连接配置页查看选项。
3. 重置提供程序缓存
   若重启后仍不显示选项，执行命令重置提供程序注册缓存：

   airflow providers reset
   

   同时删除${AIRFLOW_HOME}/.cache目录下的所有缓存文件，再次重启Webserver后重新访问页面。
4. 修复版本兼容问题
   以上操作都无效时，先执行airflow version查看当前Airflow核心版本，安装对应兼容版本的MSSQL提供程序即可。注意不要安装远高于/低于核心版本适配范围的提供程序包，否则会出现钩子注册失败、仅算子可导入的异常。

补充说明：不要以本地代码能导入MsSqlOperator作为包安装正确的判断依据——算子是独立的Python类，只要Python搜索路径下存在对应包文件就能导入，但连接类型需要提供程序实现Airflow标准的连接钩子并完成注册，注册流程失败就不会出现在前端下拉菜单中。

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