{"id":20939,"library":"apache-airflow-providers-segment","title":"Apache Airflow Provider for Segment","description":"Apache Airflow provider for Segment, enabling integration with Segment's APIs. Current version 3.9.4, released as part of the Airflow providers ecosystem. Follows Airflow's release cadence.","status":"active","version":"3.9.4","language":"python","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/providers/segment","tags":["airflow","provider","segment","etl","analytics"],"install":[{"cmd":"pip install apache-airflow-providers-segment","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Required runtime dependency for Airflow providers.","package":"apache-airflow","optional":false}],"imports":[{"note":"Deprecated import path removed in provider version 3.0.0.","wrong":"from airflow.providers.segment.operators.segment_track_event import SegmentTrackEventOperator","symbol":"SegmentTrackEventOperator","correct":"from airflow.providers.segment.operators.segment import SegmentTrackEventOperator"},{"note":"Direct import path.","symbol":"SegmentHook","correct":"from airflow.providers.segment.hooks.segment import SegmentHook"}],"quickstart":{"code":"from datetime import datetime\nfrom airflow import DAG\nfrom airflow.providers.segment.operators.segment import SegmentTrackEventOperator\n\nwith DAG(dag_id='segment_example', start_date=datetime(2021,1,1), schedule_interval=None) as dag:\n    track_event = SegmentTrackEventOperator(\n        task_id='track_event',\n        write_key='YOUR_WRITE_KEY',\n        user_id='test_user',\n        event='Test Event',\n        properties={'key': 'value'}\n    )","lang":"python","description":"Minimal DAG using SegmentTrackEventOperator. Replace 'YOUR_WRITE_KEY' with actual key."},"warnings":[{"fix":"Use import 'from airflow.providers.segment.operators.segment import SegmentTrackEventOperator'.","message":"In provider version 3.0.0, the operator was renamed from SegmentTrackEventOperator to SegmentTrackEventOperator (no change) but the module path changed from segment_track_event to segment.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Upgrade to Python 3.10+.","message":"Python 3.9 support is deprecated as of Airflow 2.10; expect removal in future versions.","severity":"deprecated","affected_versions":">=3.9.4"},{"fix":"Pass write_key explicitly via operator or set via Airflow connection.","message":"The write_key is required; if not provided, the hook will raise AirflowNotFoundException.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install apache-airflow-providers-segment'.","cause":"The provider package is not installed.","error":"ModuleNotFoundError: No module named 'airflow.providers.segment'"},{"fix":"Use 'from airflow.providers.segment.operators.segment import SegmentTrackEventOperator'.","cause":"Using an old import path; operator moved to 'segment' module in version 3.0.0.","error":"ImportError: cannot import name 'SegmentTrackEventOperator' from 'airflow.providers.segment.operators'"},{"fix":"Create a connection via UI (Conn Id: segment_default, Conn Type: Segment) or pass write_key directly to operator.","cause":"No Airflow connection configured for Segment.","error":"airflow.exceptions.AirflowNotFoundException: The conn_id `segment_default` isn't defined"},{"fix":"Upgrade to provider >=3.0.0 or use connection ID parameter 'segment_conn_id'.","cause":"Version incompatibility; older provider expects a connection ID instead of write_key.","error":"TypeError: __init__() got an unexpected keyword argument 'write_key'","affected_versions":"<3.0.0"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}