apache-airflow-providers-sftp
更新日志¶
5.7.3¶
发布日期：2026-04-12
其他¶
从 YAML 加载 hook 元数据而不导入 Hook 类 (#63826)
5.7.2¶
发布日期：2026-03-28
漏洞修复¶
修复 providers/sftp 中的导入，使其兼容 Airflow 2（#63822）当文件已不存在时返回警告而非错误（#62639）
杂项¶
添加对 Python 3.14 的支持 (#63520)
5.7.1¶
发布日期：2026-03-13
其他¶
升至 最低 cryptography 44.0.3 并 paramiko 3.4.0 （#62723）
5.7.0¶
发布日期：2026-02-02
特性¶
为 ObjectStoragePath 添加 SSH/SFTP 支持（#60757）
杂项¶
在其他提供商中使用通用提供商的 get_async_connection (#56791)
5.6.0¶
发布日期：2026-01-17
特性¶
加强 SFTPSensor 文档和功能（#60313）
其他¶
新的一年意味着版权声明的更新 (#60344)将 sftp 提供程序迁移为使用 airflow.sdk.configuration.conf（#59970）
5.5.1¶
发布日期：2025-12-13
Bug 修复¶
修复(sftp)：为 SFTPHookAsync 添加默认端口（#58945）
杂项¶
在 provider 中添加异常的向后兼容支持 (#58727)
5.5.0¶
发布日期: 2025-11-30
注意
根据 Apache Airflow providers 支持政策 <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_ 的说明，此版本的 provider 仅适用于 Airflow 2.11+。
其他¶
将 provider 中最低 Airflow 版本提升至 Airflow 2.11.0 (#58612)
5.4.2¶
发布日期：2025-11-17
杂项¶
转换所有 airflow 发行版以符合 ASF 要求 (#58138)将 sftp 提供程序迁移到 'common.compat'（#57111）
5.4.1¶
发布日期：2025-10-26
错误修复¶
Pass required remote_host arg to SSHHook (#55664)
仅限文档¶
移除变更日志和索引文件中的占位符发布日期 (#56056)
5.4.0¶
发布日期：2025-09-09
特性¶
特性：添加可选的受管连接（#52700）为模板字段添加 file_pattern（#54562）
Bug 修复¶
修复 sftp 异步钩子（#54763）
5.3.4¶
发布日期：2025-08-11
Bug 修复¶
修复 SFTPOperator 缺少 prefetch 参数（#53906）
其他¶
Limit paramiko to '< 4.0.0' till we remove DSS support (#54078)
5.3.3¶
发布日期：2025-08-02
错误修复¶
更新 SFTP 提供程序的 SSH 依赖（#53100）修复 BlobWriter（GCS）对 SFTP 流式传输的支持（#52850）
杂项¶
为 Airflow 添加 Python 3.13 支持。 (#46891)在 sftp 提供程序中尽可能清理类型忽略（#53266）mypy 升级后移除整个代码库中的 type ignore (#53243)移除“python-requires”的高版本限制 (#52980)暂时切换为使用 >=,< 模式替代“~=” (#52967)将 SFTP 中的所有 BaseHook 用法迁移到 version_compat（#52894）
仅文档¶
docs: 修正文档中 TaskFlow 的大小写 (#51794)
5.3.2¶
发布日期: 2025-07-06
Bug 修复¶
错误修复：在 SFTPHook 中移除 proxycommand 的缓存（#52641）
杂项¶
将“BaseHook”实现迁移到 task SDK (#51873)将 SFTP 中的 'models.BaseOperator' 替换为 Task SDK 的实现（#52435）停止支持 Python 3.9 (#52072)在 providers 中使用来自 task sdk 的 BaseSensorOperator (#52296)
5.3.1¶
发布日期：2025-06-18
Bug 修复¶
更新 SFTPSensor，以正确处理文件缺失的情形（#51167）
5.3.0¶
发布日期：2025-05-18
注意
此提供程序的此发行仅在 Airflow 2.10+ 上可用，详情请参阅 Apache Airflow 提供程序支持政策。
杂项¶
移除 AIRFLOW_2_10_PLUS 条件 (#49877)将 providers 中的最低 Airflow 版本提升至 2.10 (#49843)
5.2.1¶
发布日期：2025-04-19
其他¶
移除多余的 else 代码块 (#49199)
5.2.0¶
发布日期：2025-04-14
特性¶
在 SFTPOperator 中实现并发目录传输（#47533）
其他¶
使 '@task' 从 airflow.sdk 导入 (#48896)
5.1.2¶
发布日期：2025-04-09
Bug 修复¶
仅在提供 newer_than 参数时检查修改时间戳（#48063）
5.1.1¶
发布日期: 2025-03-13
Bug 修复¶
重新添加在 SFTPHook 上的 close_conn 方法；get_conn 应返回 SFTPClient，而非上下文管理的连接（#47217）
杂项¶
在目录传输中将 get_conn 改为 get_managed_conn（#47248）改进 SFTP Hook 的目录传输，使多个文件复用单一连接（#46582）升级 flit 至 3.11.0 (#46938)
5.1.0¶
发布日期：2025-02-26
特性¶
在 SFTPOperator 中添加 DELETE 操作（#46233）同样允许在 SFTPHook 的 retrieve_file 与 store_file 方法中使用 buffer 替代 path（#44247）为 SFTPOperator 添加目录传输支持（#44126）
Bug 修复¶
确保在 SFTPHook 的上下文管理器中使用连接时，SSHClient 也被关闭（#46716）
杂项¶
AIP-72：在 SDK 中为 Context 字典提供更好的类型提示支持 (#45583)
5.0.0¶
发布日期：2024-12-26
注意
如 Apache Airflow 提供商支持策略中所述，此版本的提供商仅适用于 Airflow 2.9+。
破坏性变更¶
警告
所有已弃用的类、参数和功能已从 sftp 提供程序包中移除。引入了以下不兼容的更改：
从
SFTPOperator中移除已弃用的ssh_hook参数，请改用sftp_hook。从
SFTPHook中移除已弃用的ssh_hook参数。从
SFTPHook中移除已弃用的ftp_conn_id参数，请改用ssh_conn_id。
从 SFTP Provider 中移除所有已弃用的特性（#44740）
特性¶
特性：一次性检索 sftp 文件属性，而非多次检索（#44625）Add host_proxy_cmd parameter to SSHHook and SFTPHook (#44565)
杂项¶
将提供商中最低 Airflow 版本提升至 Airflow 2.9.0 (#44956)
4.11.1¶
发布日期：2024-09-24
其他¶
从 providers 中移除已弃用的 soft_fail (#41710)
4.11.0¶
发布日期：2024-08-22
注意
根据 Apache Airflow provider 支持政策，此版本的 provider 仅适用于 Airflow 2.8+。
其他¶
将各 provider 的最低 Airflow 版本提升至 Airflow 2.8.0 (#41396)
4.10.3¶
发布日期：2024-08-06
其他¶
openlineage：将 OpenLineage 提供程序迁移至 V2 facets。 (#39530)
4.10.2¶
发布日期：2024-06-27
Bug 修复¶
修复 SFTPSensor 的资源管理（#40022）
其他¶
实现 每个 provider 的 tests 并使用 最低直接依赖解析 （#39946）
4.10.1¶
发布日期：2024-05-30
Bug 修复¶
修复 SFTPSensor.newer_than 在 Jinja 逻辑 ds/ts 表达式下无法工作的问题（#39056）
其他¶
更快的 'airflow_version' 导入 (#39552)简化 'airflow_version' 导入 (#39497)
4.10.0¶
发布日期：2024-05-06
注意
正如 Apache Airflow 提供者支持策略 中所述，此版本的提供者仅适用于 Airflow 2.7+。
其他¶
将提供者中的最低 Airflow 版本提升至 Airflow 2.7.0 (#39240)
4.9.1¶
发布日期：2024-04-13
漏洞修复¶
修复(sftp)：在触发器的 while 循环中为 yield 添加 return 语句（#38391）关闭可延迟（deferrable）SFTPSensor 的打开连接（#38881）
4.9.0¶
发布日期: 2024-02-15
功能特性¶
在 SFTPSensor 中添加 deferrable 参数（#37117）
4.8.1¶
发布日期：2023-12-27
Bug 修复¶
更改警告信息（#36148）在子类中遵循 BaseHook 连接字段的方法签名 (#36086)
杂项¶
通过 Ruff 在文档字符串中添加代码片段格式化 (#36262)
4.8.0¶
发布日期：2023-12-12
注意
正如 Apache Airflow 提供者支持策略 中所述，此版本的提供者仅适用于 Airflow 2.6+。
杂项¶
将 provider 中 最低 Airflow 版本 提升至 Airflow 2.6.0 (#36017)
4.7.0¶
发布日期：2023-10-17
注意
如 Apache Airflow providers 支持策略 中所述，此版本的 provider 仅适用于 Airflow 2.5+。
杂项¶
提升 providers 的最低 airflow 版本 (#34728)
4.6.1¶
发布日期：2023-09-12
Bug 修复¶
修复(providers/sftp)：在抛出异常时尊重 soft_fail 参数（#34169）
杂项¶
通过将部分模块导入放入类型检查块 改进 Airflow providers 的 modules import （#33754）
4.6.0¶
发布日期：2023-08-29
功能特性¶
为 SFTPToGCSOperator 添加 sftp_prefetch 参数 (#33274)
其他¶
重构：删除无用的 str() 调用 (#33629)
4.5.0¶
发布日期: 2023-08-01
功能¶
openlineage、sftp：为 sftp 提供程序添加 OpenLineage 支持（#31360）
4.4.0¶
发布日期: 2023-07-16
功能¶
新增 sftp_sensor 装饰器（#32457）
4.3.1¶
发布日期: 2023-06-23
注意
此版本停止了对 Python 3.7 的支持
杂项¶
添加 关于 在 提供程序 中 移除 Python 3.7 的 说明 (#32015)
4.3.0¶
发布日期: 2023-05-22
注意
正如 Apache Airflow 提供者支持政策中所述，此版本的提供者仅适用于 Airflow 2.4+。
杂项¶
提高提供者中的最低 Airflow 版本要求 (#30917)
4.2.4¶
发布日期：2023-03-06
Bug 修复¶
修复在使用 newer_than 且匹配到多个文件时的 SFTPSensor（#29794）
4.2.3¶
发布日期：2023-02-21
Bug 修复¶
修复带有 pattern 的 sftp sensor（#29467）
4.2.2¶
发布日期：2023-02-11
漏洞修复¶
修复 SFTP operator 的模板字段处理（#29068）FTP operator 在 __init__ 中包含逻辑 (#29073)
4.2.1¶
发布日期：2023-01-05
杂项 (Misc)¶
更新 codespell 并修正拼写错误（#28568）[杂项] 在条件语句中摆脱 'pass' 语句 (#27775)
4.2.0¶
发布日期：2022-11-18
注意
正如 Apache Airflow 提供程序支持策略中所述，此版本的提供程序仅适用于 Airflow 2.3+。
杂项¶
将所有提供程序的最低 airflow 版本移至 2.3.0 (#27196)
错误修复¶
SFTP Provider：修复默认文件夹权限（#26593）
4.1.0¶
发布日期：2022-10-01
功能特性¶
SFTPOperator - 添加对文件路径列表的支持（#26666）
4.0.0¶
发布日期：2022-07-20
不兼容的更改
Convert sftp hook to use paramiko instead of pysftp (#24512)
特性
将 'actual_file_to_check' 更新为渲染后的 'path'（#24451）
3.0.0¶
发布日期：2022-06-13
不兼容的更改
注意
此版本的 provider 仅适用于 Airflow 2.2+，详情请参阅 Apache Airflow provider 支持政策。
功能特性¶
向 SFTPSensor 添加 fnmatch 类型正则表达式（#24084）
2.6.0¶
发布日期：2022-04-11
特性 (Features)¶
为 SFTP sensor 添加 newer_than 参数（#21655）（#22377）
2.5.2¶
发布日期：2022-03-26
漏洞修复¶
修复错误地为所有 provider 添加的 install_requires (#22382)
2.5.1¶
发布日期：2022-03-19
杂项¶
在 PyPI 中添加 Trove 分类器 (Framework :: Apache Airflow :: Provider)
2.5.0¶
发布日期： 2022-03-10
特性
更新 FTPHook 提供程序以包含 test_connection (#21997)
杂项¶
支持 Python 3.10在 提供者 中 添加 可选 特性 (#21074)
2.4.1¶
发布日期：2022-01-12
Bug 修复 (Bug Fixes)¶
错误修复：''SFTPHook'' 未尊重 ''ssh_conn_id'' 参数（#20756）修复 SFTPHook 的已弃用信息（#20692）
2.4.0 (YANKED)¶
警告
此发行版已被撤回，原因：在 ssh_conn_id 上发现不兼容的更改
特性¶
使 SFTPHook 的构造函数与其基类 SSHHook 保持一致（#20164）
2.3.0¶
发布日期： 2021-12-06
特性 (Features)¶
为 sftp hook 添加 test_connection 方法（#19609）
2.2.0¶
发布日期： 2021-11-04
功能特性¶
SFTP hook 优先使用 SSH paramiko 密钥而非密钥文件路径（#18988）
2.1.1¶
发布日期：2021-09-03
杂项¶
为 Airflow 2.2.0 优化连接导入
2.1.0¶
发布日期：2021-08-02
功能特性¶
Add support for non-RSA type key for SFTP hook (#16314)
2.0.0¶
发布日期：2021-06-23
不兼容的更改
自动应用 apply_default 装饰器 (#15667)
警告
由于移除了 apply_default 装饰器，此版本的提供程序需要 Airflow 2.1.0+。如果您的 Airflow 版本 < 2.1.0，并且您想要安装此提供程序版本，请先将 Airflow 升级到至少 2.1.0 版本。否则，您的 Airflow 软件包版本将自动升级，并且您必须手动运行 airflow upgrade db 来完成迁移。
特性¶
在 SFTPHook 的连接 extra 中废弃 private_key_pass，并改名为 private_key_passphrase（#14028）
1.2.0¶
发布日期：2021-05-06
特性
撤销对 SFTPHook 中 private_key 选项的已弃用状态（#15348）在 SFTP、FTP 和文件系统传感器中添加显示最后修改时间的日志 (#15134)
1.1.1¶
发布日期：2021-03-07
特性¶
SFTPHook 的 extra 参数 private_key_pass 已废弃并更名为 private_key_passphrase，以保持与 SSHHook 参数命名的一致性。
错误修复
更正 文档 和 工具 在 发布 提供程序 RC 之后 (#14082)
1.1.0¶
发布日期：2021-02-08
更新了文档和 README 文件。
特性
为 SFTP hook 的连接添加重试器（#13065）
1.0.0¶
发布日期： 2020-12-14
提供程序的初始版本。