Python Cassandra Driver

A Python client driver for Apache Cassandra. This driver works exclusively with the Cassandra Query Language v3 (CQL3) and Cassandra’s native protocol. Cassandra 2.1+ is supported.

The driver supports Python 2.7, 3.4, 3.5, and 3.6.

This driver is open source under the Apache v2 License. The source code for this driver can be found on GitHub.

Note: DataStax products do not support big-endian systems.



How to install the driver.

Getting Started

A guide through the first steps of connecting to Cassandra and executing queries

Object Mapper

Introduction to the integrated object mapper, cqlengine

API Documentation

The API documentation.


A guide to upgrading versions of the driver

Execution Profiles

An introduction to a more flexible way of configuring request execution

Performance Notes

Tips for getting good performance.

Paging Large Queries

Notes on paging large query results

Lightweight Transactions (Compare-and-set)

Working with results of conditional requests

User Defined Types

Working with Cassandra 2.1’s user-defined types


An overview of the security features of the driver

Working with Dates and Times

Some discussion on the driver’s approach to working with timestamp, date, time types

Frequently Asked Questions

A collection of Frequently Asked Questions

Getting Help

Visit the FAQ section in this documentation.

Please send questions to the mailing list.

Alternatively, you can use the #datastax-drivers channel in the DataStax Acadamy Slack to ask questions in real time.

Reporting Issues

Please report any bugs and make any feature requests on the JIRA issue tracker.

If you would like to contribute, please feel free to open a pull request.