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 個月發生而導致廢棄），此期間可以進行調整。