/
/
Python

Couchbase Python Connector

Read, write, and update Couchbase with Python

Easily connect Python-based data access, visualization, ORM, ETL, AI/ML, and custom apps with Couchbase!

Other Database Technologies
Decorative Icon Couchbase Logo
Claude
Claude
GitHub Copilot
Gemini
New
CData Drivers now work with AI Coding tools

Python Connector Libraries for Couchbase Data Connectivity. Integrate Couchbase with popular Python tools like Pandas, SQLAlchemy, Dash & petl. Easy-to-use Python Database API (DB-API) Modules connect Couchbase data with Python and any Python-based applications.

Features

Compatible with Couchbase 4.0 and above
Full read/write support for the Couchbase Query (N1QL) service
Full support for the read-only Couchbase Analytics (SQL++) service
Includes a N1QL/SQL++ pass-through query option
Enables SQL-92 capabilities on Couchbase NoSQL data.
Flexible NoSQL flattening - automatic schema generation, flexible querying etc.
Connect to live Couchbase data, for real-time data access with the Couchbase Python Connectors
Full support for data aggregation and complex JOINs in SQL queries
Secure connectivity through modern cryptography, including TLS 1.2, SHA-256, ECC, etc.
Seamless integration with leading BI, reporting, and ETL tools and with custom applications via the Couchbase Connector.

Specifications

Python Database API (DB-API) Modules for Couchbase with bi-directional access.
Write SQL, get Couchbase data. Access Couchbase through standard Python Database Connectivity.
Integration with popular Python tools like Pandas, SQLAlchemy, Dash & petl.
An easy-to-use 'flattened' interface for working with Couchbase NoSQL databases.
Full Unicode support for data, parameter, & metadata.

CData Python connectors in action!

Watch the video overview for a first hand-look at the powerful data integration capabilities included in the CData Python Connectors.

Watch the Python Connector Video Overview

Python connectivity with Couchbase

Full-featured and consistent SQL access to any supported data source through Python


Connecting to Couchbase with Python

CData Python Connectors leverage the Database API (DB-API) interface to make it easy to work with Couchbase from a wide range of standard Python data tools. Connecting to and working with your data in Python follows a basic pattern, regardless of data source:

  • Configure the connection properties to Couchbase
  • Query Couchbase to retrieve or update data
  • Connect your Couchbase data with Python data tools.


Connecting to Couchbase in Python

To connect to your data from Python, import the extension and create a connection:

Once you import the extension, you can work with all of your enterprise data using the python modules and toolkits that you already know and love, quickly building apps that help you drive business.

import cdata.couchbase as mod
conn = mod.connect("[email protected]; Password=password;")

#Create cursor and iterate over results
cur = conn.cursor()
cur.execute("SELECT * FROM Documents")
	
rs = cur.fetchall()
	
for row in rs:
print(row)
		
engine = create_engine("couchbase///Password=password&User=user")

df = pandas.read_sql("SELECT * FROM Documents", engine)

df.plot()
plt.show()

Visualize Couchbase Data with pandas

The data-centric interfaces of the Couchbase Python Connector make it easy to integrate with popular tools like pandas and SQLAlchemy to visualize data in real-time.

More than read-only: full update/CRUD support

Couchbase Connector goes beyond read-only functionality to deliver full support for Create, Read Update, and Delete operations (CRUD). Your end-users can interact with the data presented by the Couchbase Connector as easily as interacting with a database table.

AI-assisted development with CData CLI

Build Couchbase integrations faster with AI that understands your schema

Schema-aware AI

CData CLI gives AI coding tools access to your Couchbase schema. No more guessing table names or column types—AI sees the same metadata in your Python Connectors.

Your AI Knows SQL

How to find table names, column names, and how to generate SQL syntax are things that AI knows well from millions of training data. No need for customization, no hallucinations. Your AI acts like a domain specialist to Couchbase.

More Accurate, More Token-Efficient

With CData CLI's queryable schema detection and highly efficient queries with filters, aggregation, joins with correct pushdown, your AI will achieve more accuracy with less token usage.

Supported AI Coding Tools
Download CData CLI