{"id":4877,"library":"apache-airflow-providers-yandex","title":"Apache Airflow Yandex Provider","description":"The `apache-airflow-providers-yandex` package extends Apache Airflow with operators and hooks to interact with various Yandex Cloud services, including Yandex Query and Yandex Data Proc. It is an actively maintained provider, with a regular release cadence to ensure compatibility with new Airflow versions and Yandex Cloud features. The current version is 4.4.2.","status":"active","version":"4.4.2","language":"en","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/airflow/providers/yandex","tags":["apache-airflow","provider","yandex","yandex-cloud","etl","orchestration"],"install":[{"cmd":"pip install apache-airflow-providers-yandex","lang":"bash","label":"Install the provider package"}],"dependencies":[{"reason":"Core Airflow functionality; required minimum version varies by provider version.","package":"apache-airflow","optional":false},{"reason":"Yandex Cloud SDK for API interactions.","package":"yandexcloud","optional":false}],"imports":[{"symbol":"YQExecuteQueryOperator","correct":"from airflow.providers.yandex.operators.yq import YQExecuteQueryOperator"},{"note":"The `yandex.hooks.yandexcloud_dataproc` module was removed in provider version 4.4.1. Use `airflow.providers.yandex.hooks.yandexcloud` instead.","wrong":"from yandex.hooks.yandexcloud_dataproc import YandexCloudBaseHook","symbol":"YandexCloudBaseHook","correct":"from airflow.providers.yandex.hooks.yandexcloud import YandexCloudBaseHook"}],"quickstart":{"code":"from __future__ import annotations\n\nimport os\n\nimport pendulum\n\nfrom airflow.models.dag import DAG\nfrom airflow.providers.yandex.operators.yq import YQExecuteQueryOperator\n\n# Ensure you have a Yandex Cloud connection configured in Airflow UI\n# with conn_id='yandexcloud_default' or specify 'yandex_conn_id' in the operator.\n# Set YANDEX_CLOUD_FOLDER_ID in your Airflow connection's 'extra' field\n# or as an environment variable for the operator to pick up.\n\nwith DAG(\n    dag_id=\"yandex_query_example\",\n    start_date=pendulum.datetime(2023, 1, 1, tz=\"UTC\"),\n    catchup=False,\n    schedule=None,\n    tags=[\"yandex\", \"example\"],\n) as dag:\n    execute_yq_query = YQExecuteQueryOperator(\n        task_id=\"run_simple_yandex_query\",\n        sql=\"SELECT 'Hello, world!' AS message;\",\n        # Optional: Specify a connection ID if not using 'yandexcloud_default'\n        # yandex_conn_id='my_yandex_cloud_connection',\n        # Optional: Specify a folder ID directly, or it will be picked from connection's extra or env var\n        # folder_id=os.environ.get('YANDEX_CLOUD_FOLDER_ID', ''),\n    )\n","lang":"python","description":"This quickstart demonstrates how to use the `YQExecuteQueryOperator` to run a simple SQL query in Yandex Query. Ensure you have configured a Yandex Cloud connection in your Airflow environment. The operator will use the `yandexcloud_default` connection by default. Folder ID can be specified in the connection's extra field or as an environment variable."},"warnings":[{"fix":"Use `utils.user_agent.provider_user_agent` instead of `YandexCloudBaseHook.provider_user_agent`. Use `yandex_conn_id` instead of `connection_id` for hooks and operators. Update imports for `YandexCloudBaseHook` to `airflow.providers.yandex.hooks.yandexcloud`.","message":"Provider version 4.4.1 and later removed `YandexCloudBaseHook.provider_user_agent` and `YandexCloudBaseHook.connection_id` parameter. The `yandex.hooks.yandexcloud_dataproc` module was also removed.","severity":"breaking","affected_versions":"4.4.1+"},{"fix":"Ensure your Apache Airflow installation meets or exceeds the minimum version required by the provider package. Upgrade Airflow if necessary, and run `airflow upgrade db` if a major Airflow version upgrade is performed.","message":"Provider versions have minimum Apache Airflow version requirements. For example, provider 2.0.0+ requires Airflow 2.1.0+, provider 3.0.0+ requires Airflow 2.2.0+, and provider 3.2.0+ requires Airflow 2.3.0+. The current version 4.4.2 requires Airflow 2.11.0+.","severity":"breaking","affected_versions":"2.0.0+, 3.0.0+, 3.2.0+, 4.4.2"},{"fix":"Prefer using non-prefixed extra fields in your Airflow connection configuration for Yandex Cloud connections. For example, use `folder_id` directly in the 'Extra' JSON instead of `extra__yandexcloud__folder_id`.","message":"When using `YandexCloudBaseHook`, non-prefixed extra fields (e.g., `folder_id`) are supported and preferred over prefixed ones (e.g., `extra__yandexcloud__folder_id`) since provider version 3.2.0.","severity":"gotcha","affected_versions":"3.2.0+"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}