{"id":27588,"library":"apache-airflow-providers-apache-tinkerpop","title":"Apache Airflow Provider for Apache TinkerPop","description":"Apache Airflow provider to interact with Apache TinkerPop graph databases. Version 1.1.3 was released in 2025, with a monthly release cadence. Requires Python >=3.10.","status":"active","version":"1.1.3","language":"python","source_language":"en","source_url":"https://github.com/apache/airflow","tags":["airflow","provider","tinkerpop","gremlin"],"install":[{"cmd":"pip install apache-airflow-providers-apache-tinkerpop","lang":"bash","label":"Install latest release"}],"dependencies":[{"reason":"Required. Provider runs within Airflow.","package":"apache-airflow","optional":false}],"imports":[{"note":"Use the correct module path.","symbol":"TinkerpopHook","correct":"from airflow.providers.apache.tinkerpop.hooks.tinkerpop import TinkerpopHook"},{"note":"Operator class for submitting Gremlin queries.","symbol":"TinkerpopOperator","correct":"from airflow.providers.apache.tinkerpop.operators.tinkerpop import TinkerpopOperator"}],"quickstart":{"code":"from datetime import datetime\nfrom airflow import DAG\nfrom airflow.providers.apache.tinkerpop.operators.tinkerpop import TinkerpopOperator\n\ndag = DAG('tinkerpop_example', start_date=datetime(2023,1,1), schedule=None)\ntask = TinkerpopOperator(\n    task_id='query_graph',\n    gremlin_query=\"g.V().limit(1)\",\n    host='localhost',\n    port=8182,\n    dag=dag\n)","lang":"python","description":"Basic DAG using TinkerpopOperator to run a Gremlin query."},"warnings":[{"fix":"Always set the gremlin_query argument.","message":"TinkerpopOperator requires a gremlin_query parameter; if omitted, the operator fails at runtime.","severity":"gotcha","affected_versions":"all"},{"fix":"Explicitly set 'port' in the hook or operator.","message":"The hook uses TCP port 8182 by default, but many environments use different ports. Verify connectivity.","severity":"gotcha","affected_versions":"all"},{"fix":"Update connection to use conn_type='tinkerpop'.","message":"In older versions, the connection type was 'tinkerpop'; ensure you use the correct connection ID in Airflow.","severity":"deprecated","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'pip install apache-airflow-providers-apache-tinkerpop' and ensure Airflow is installed.","cause":"Provider package not installed or Airflow environment not activated.","error":"ModuleNotFoundError: No module named 'airflow.providers.apache.tinkerpop'"},{"fix":"Upgrade to latest provider: 'pip install --upgrade apache-airflow-providers-apache-tinkerpop'","cause":"Using an older version of the provider that expected a 'query' parameter.","error":"TypeError: __init__() got an unexpected keyword argument 'gremlin_query'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}