Registry / workflow / apache-airflow-providers-arangodb

apache-airflow-providers-arangodb

library2.9.4pypypi✓ verified 52d ago

Apache Airflow provider package to integrate with ArangoDB. Version 2.9.4 supports Airflow 2.x and requires Python >=3.10. Allows use of ArangoDB as a metadata database and provides ArangoDBHook and operators.

workflow database devops

pip install apache-airflow-providers-arangodb

github ↗package ↗docs ↗changelog ↗

Install & Compatibility

Where this runs

tested against v2.9.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 5.430s · 252.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 23.3s · import 4.938s · 250MB

252MB installed

● package 252MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ArangoDBHook

✓ from airflow.providers.arangodb.hooks.arangodb import ArangoDBHook

✗ from airflow.providers.arangodb.hooks.arango_hook import ArangoDBHook

Incorrect old import path

Create a DAG that executes an AQL query using ArangoDBOperator. Ensure connection is configured.

from airflow import DAG from airflow.providers.arangodb.operators.arangodb import ArangoDBOperator from datetime import datetime with DAG(dag_id='arangodb_example', start_date=datetime(2024,1,1), schedule=None, catchup=False) as dag: query = ArangoDBOperator( task_id='run_query', arangodb_conn_id='arangodb_default', query='FOR doc IN collection RETURN doc', result_processor=lambda results: print(results), do_xcom_push=True )

Debug

Known issues

breakingProvider dropped support for Python 3.9 in version 2.8.0. Upgrade to Python >=3.10.

fix

Use Python 3.10+ (recommended 3.11).

affects: >=2.8.0

gotchaArangoDBHook uses python-arango library. Connection URI format: 'arangodb://user:pass@host:port/db' or via Airflow connection extra fields including 'host', 'port', 'username', 'password', 'database'.

fix

Set connection in Airflow UI as type 'ArangoDB', host/port/login/password, and extra '{"database": "your_db"}'.

affects: all

gotchaArangoDBOperator returns raw python-arango query result; result_processor is called if provided. If not, result is pushed to XCom as a dict.

fix

Use result_processor to handle or transform result.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'airflow.providers.arangodb'

Provider not installed or Airflow not restarted after install.

fix

Run 'pip install apache-airflow-providers-arangodb' and restart Airflow webserver/scheduler.

airflow.exceptions.AirflowException: The conn_id `arangodb_default` isn't defined

Connection not configured in Airflow.

fix

Create an ArangoDB connection via Admin UI: Admin > Connections > Add, set Conn Id: arangodb_default, Conn Type: ArangoDB, Host, Login, Password, Port (8529), Extra: {"database": "your_database"}.

TypeError: Object of type Cursor is not JSON serializable

ArangoDBOperator returns a python-arango Cursor, which Airflow tries to serialize for XCom.

fix

Use result_processor to convert result to a list/dict: result_processor=lambda res: list(res).

Upgrade

Version history

2.9.5latest on PyPI

Audit

Dependencies

apache-airflowrequiredRequired: Airflow provider base

python-arangorequiredRequired: ArangoDB driver

Agent activity

77 hits · last 30 days

node

claudebot

ahrefsbot

amazonbot

Resources

githubhttps://github.com/apache/airflow ↗

packagehttps://pypi.org/project/apache-airflow-providers-arangodb/ ↗

docshttps://airflow.apache.org/docs/apache-airflow-providers-arangodb/2.9.4 ↗

changeloghttps://airflow.apache.org/docs/apache-airflow-providers-arangodb/2.9.4/changelog.html ↗