apache-airflow-providers-google 包的废弃策略¶

包的版本控制¶

如Airflow 发布流程和版本策略中所述，Google Provider 包（及其他包）应遵循语义化版本规范（SemVer），这意味着任何重大变更都应与包主版本的提升一起发布。如果某个 DAG 在变更前可以正常工作，但在变更后停止工作，则该变更被视为重大变更。

废弃流程¶

整个废弃过程（无论是方法、参数还是操作符）包含两个步骤

使用装饰器将对象标记为已废弃，并指定计划移除日期以及可用于替代该废弃对象的其他对象

from airflow.providers.google.common.deprecated import deprecated
from airflow.exceptions import AirflowProviderDeprecationWarning


@deprecated(
    planned_removal_date="September 30, 2025",
    use_instead="airflow.providers.google.cloud.hooks.vertex_ai.auto_ml.AutoMLHook",
    category=AirflowProviderDeprecationWarning,
)
def example() -> None: ...

一旦超过了已废弃方法/参数/操作符的日期，就可以将其移除，同时提升包的主版本。

额外注意事项¶

默认情况下，所有废弃都应提供 6 个月的过渡期，之后才会移除并不可用。此期间将为 Airflow 用户提供充足的时间和灵活性，以便在实际移除发生之前更新其 DAG。在特殊情况下（例如，由于底层 API 关闭可能早于 6 个月发生而导致废弃），此期间可以进行调整。

此条目有帮助吗？