Registry /
workflow / apache-airflow-providers-cloudant
Install & Compatibility
Where this runs
tested against v4.3.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
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 5.307s · 252.9MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 23.5s · import 4.877s · 250MB
252MB installed
● package 252MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CloudantHook
✓ from airflow.providers.cloudant.hooks.cloudant import CloudantHook
The hook is used in operators and sensors; no common wrong import known.
CloudantCreateDocumentOperator
✓ from airflow.providers.cloudant.operators.cloudant import CloudantCreateDocumentOperator
The main operator to create a document.
CloudantGetDataOperator
✓ from airflow.providers.cloudant.operators.cloudant import CloudantGetDataOperator
Operator to retrieve data from Cloudant.
CloudantDeleteDocumentOperator
✓ from airflow.providers.cloudant.operators.cloudant import CloudantDeleteDocumentOperator
Operator to delete a document.
CloudantSensor
✓ from airflow.providers.cloudant.sensors.cloudant import CloudantSensor
Sensor for Cloudant. Some older documentation may reference a different import.
Minimal DAG that creates a document in Cloudant. Requires a Cloudant connection defined in Airflow with the 'cloudant_default' conn_id.
from datetime import datetime
from airflow import DAG
from airflow.providers.cloudant.hooks.cloudant import CloudantHook
from airflow.providers.cloudant.operators.cloudant import CloudantCreateDocumentOperator
default_args = {
'owner': 'airflow',
'start_date': datetime(2024, 1, 1),
}
with DAG('cloudant_example', default_args=default_args, schedule_interval=None) as dag:
create_doc = CloudantCreateDocumentOperator(
task_id='create_doc',
cloudant_conn_id='cloudant_default',
database='my_database',
doc={'name': 'example', 'value': 42},
)
airflow --version
Errors
Common errors & fixes
airflow.exceptions.ConnectionNotFoundException: The conn_id `cloudant_default` isn't defined
The Cloudant connection is not configured in Airflow.
fixDefine a connection in Airflow UI or via environment variable: export AIRFLOW_CONN_CLOUDANT_DEFAULT='cloudant://user:pass@account.cloudant.com:443/my_database'
ImportError: cannot import name 'CloudantHook' from 'airflow.providers.cloudant.hooks'
Installed version is too old (pre-4.0.0) or import path is incorrect.
fixUpgrade to the latest version and use 'from airflow.providers.cloudant.hooks.cloudant import CloudantHook'.
urllib3.exceptions.MaxRetryError: HTTPConnectionPool(host='account.cloudant.com', port=443): Max retries exceeded with url: /my_database/ (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at ...>: Failed to establish a new connection: [Errno -2] Name or service not known'))
Hostname in connection is incorrect (missing scheme or wrong domain).
fixEnsure the host in the connection includes 'https://' and the full domain (e.g., 'https://account.cloudant.com').
Upgrade
Version history
4.3.5latest on PyPI · released Jun 7, 2026
Audit
Dependencies
No dependency data recorded yet.