Airflow 2.2.2 集成SQL Server 2019作为元数据库出现IDENTITY_INSERT报错如何解决？

该报错是SQL Server默认规则与Airflow使用的SQLAlchemy ORM生成语句逻辑冲突导致：ab_permission表的id列为IDENTITY自增属性，SQL Server默认禁止手动向自增列插入值，而Airflow生成的SQL语句显式向id列插入序列ab_permission_id_seq的取值，触发规则报错。

排查步骤 #

• 首先确认Airflow配置文件中的数据库连接串格式正确，已指定ODBC Driver 17 for SQL Server驱动，无多余错误参数
• 登录SQL Server对应元数据库，检查表结构：确认ab_permission等权限表的id列是否带有IDENTITY属性，同时确认是否存在ab_permission_id_seq等同名序列对象，二者同时存在是触发冲突的核心原因
• 确认当前环境安装的SQLAlchemy版本，Airflow 2.2.2默认绑定的低版本SQLAlchemy存在SQL Server下序列与自增列识别冲突的bug

解决方法 #

1. 升级SQLAlchemy到兼容版本，执行命令：

pip install sqlalchemy>=1.4.30

该版本修复了SQL Server场景下序列和自增列的逻辑识别冲突，不会再生成手动插入自增列的SQL语句。

2. 修改airflow.cfg中的数据库连接串，添加identity_insert=False参数，告知SQLAlchemy使用SQL Server自增列逻辑而非手动插入值，完整连接串示例：

sql_alchemy_conn = mssql+pyodbc://<数据库用户名>:<数据库密码>@<数据库地址>/<元数据库名>?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=yes&identity_insert=False

3. 如果是首次初始化元数据库，先删除之前初始化生成的不完整的表和序列，避免残留结构冲突，再重新执行初始化命令：

airflow db init

4. 若仍出现同类型报错，可临时开启对应表的IDENTITY_INSERT权限，初始化完成后关闭，执行SQL示例：

SET IDENTITY_INSERT ab_permission ON;
-- 其他触发同类型报错的表依次执行该命令，比如ab_role、ab_permission_view、ab_user等
SET IDENTITY_INSERT ab_permission OFF;

注意事项 #

• Airflow 2.2.2对SQL Server作为元数据库的支持还处于测试阶段，如果业务条件允许，建议升级到Airflow 2.4及以上版本，对SQL Server的兼容性做了大量优化，可避免大部分同类问题
• 需提前确认服务器端已正确安装ODBC Driver 17 for SQL Server，避免驱动层面的兼容错误

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