Docker部署Airflow中无法找到SQL Server连接类型求助

核心原因 #

Airflow官方基础镜像仅预装了PostgreSQL等常用数据库的连接依赖，SQL Server对应的连接支持依赖apache-airflow-providers-microsoft-mssql provider包，默认未安装，因此UI中不会显示该连接类型。

解决步骤 #

1. 自定义Docker镜像（生产/长期使用推荐） #

针对Docker部署场景，最稳定的方式是基于官方镜像扩展安装所需provider：

• 在Airflow项目根目录创建Dockerfile：

FROM apache/airflow:2.x.x  # 替换为你当前使用的Airflow版本，比如2.8.0
RUN pip install apache-airflow-providers-microsoft-mssql==x.x.x  # 替换为与Airflow版本兼容的provider版本，可参考Airflow官方版本矩阵

• 修改docker-compose.yaml，将原镜像配置image: apache/airflow:xxx替换为build: .，让Docker构建自定义镜像
• 重启Airflow服务：

docker-compose down -v
docker-compose up --build -d

2. 临时容器内安装（测试场景） #

若仅需临时验证，可直接进入运行中的Airflow容器安装：

# 查找Airflow webserver容器ID
docker ps | grep airflow-webserver
# 进入容器
docker exec -it <容器ID> bash
# 安装SQL Server provider
pip install apache-airflow-providers-microsoft-mssql
# 重启webserver容器生效
docker restart <容器ID>

注意：此方式在容器重启后会失效，仅适合临时测试。

3. 验证结果 #

重启后刷新Airflow UI，进入Admin > Connections页面，点击+新建连接，即可在Connection Type下拉框中找到Microsoft SQL Server（或MSSQL）选项。

版本兼容提示 #

需确保apache-airflow-providers-microsoft-mssql版本与Airflow主版本匹配，例如：

• Airflow 2.8.x 对应 provider 4.x.x
• Airflow 2.7.x 对应 provider 3.x.x
  版本不匹配会导致安装失败或连接异常。

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