How to install cassandra-cpp on Ubuntu?

Install the DataStax C/C++ driver via package manager or from source, then ensure libcassandra files are in /usr/local/lib64/. Use Floki for a Dockerized setup if preferred, as per the README.

Is cassandra-cpp compatible with Tokio?

Yes, it uses std::future, so it works with any async runtime like Tokio or async-std. You can use tokio::runtime::Runtime::block_on to call async functions from synchronous code.

How to migrate from cassandra-cpp version 2.0 to 3.0?

Update iterator usage from for loops to while let with lending iterators, as described in the README. Expect lifetime adjustments and changes to types like Value .

cassandra-cpp vs cdrs: which is better for Cassandra in Rust?

cassandra-cpp offers full DataStax driver features with async support but requires C++ dependencies. cdrs is a pure Rust alternative with simpler setup but may lack some advanced features. Choose based on need for official driver integration vs. dependency minimalism.

How to use prepared statements in cassandra-cpp?

Use Session::prepare to create a PreparedStatement, then execute it with Session::execute. Note that statements are consumed on execution, so recreate them if needed for reuse.

Does cassandra-cpp support SSL configuration?

Yes, via Cluster::set_ssl which consumes an SSL context for safety. Enable early_access_min_tls_version feature flag for specific TLS versions if using a compatible DataStax driver.

What's the performance overhead of cassandra-cpp?

As a thin wrapper, overhead is minimal, but FFI calls and Rust safety checks might add slight latency compared to direct C++ usage. For most apps, it's negligible given the safety benefits.

Open-Awesome

cassandra-rs

Apache-2.0Rust3.0.2

A maintained Rust driver for Apache Cassandra, wrapping the DataStax C/C++ driver with a safe and modern API.

GitHub

144 stars56 forks0 contributors

What is cassandra-rs?

cassandra-cpp is a Rust driver for Apache Cassandra that provides a safe and modern API for interacting with Cassandra databases using CQL. It wraps the DataStax C/C++ driver, offering Rust developers a maintained and idiomatic way to perform database operations with async support and sound iterator implementations.

Target Audience

Rust developers building applications that require interaction with Apache Cassandra databases, particularly those needing a reliable and safe driver with modern async capabilities.

Value Proposition

Developers choose cassandra-cpp because it is a maintained fork of an unproject, addresses soundness issues in the API, and provides a safe wrapper around the robust DataStax C/C++ driver with full async support.

Overview

Cassandra (CQL) driver for Rust, using the DataStax C/C++ driver under the covers.

Use Cases

Best For

Building async Rust applications that query Apache Cassandra
Migrating from older Cassandra Rust drivers to a maintained solution
Ensuring soundness and safety in Cassandra database interactions
Leveraging the full feature set of the DataStax C/C++ driver from Rust
Developing data-intensive services with non-blocking database access
Integrating Cassandra into Rust microservices or distributed systems

Not Ideal For

Projects requiring quick, dependency-free installation without manual C++ driver setup
Teams preferring pure Rust drivers to avoid C/C++ bindings and FFI complexities
Applications that frequently reuse database statements across executions (statements are consumed on execute)
Environments where Dockerized development or specific library paths aren't feasible

Pros & Cons

Pros

Modern Async Support

Uses std::future and async/await, enabling seamless integration with Rust's async ecosystem for non-blocking database operations.

Sound Iterator Design

Implements a lending iterator API that prevents data invalidation, fixing a critical soundness issue from earlier versions and enhancing safety.

Enhanced Session Safety

Associates statements with specific sessions, reducing resource leaks and errors like BatchSessionMismatch, as highlighted in the version 2.0 changes.

Comprehensive Driver Coverage

Wraps the full DataStax C/C++ driver, exposing features like SSL, batches, and prepared statements without sacrificing functionality.

Cons

Complex Installation Process

Requires manual installation of the DataStax C/C++ driver with platform-specific steps, making setup error-prone and time-consuming compared to crates with bundled dependencies.

Frequent Breaking Changes

Major versions (e.g., 2.0 and 3.0) introduce API breaks, such as the lending iterator and session-associated statements, necessitating significant code migrations.

Dependency on C++ Ecosystem

Relies on an external C++ library, leading to potential build complexities, FFI overhead, and compatibility issues that pure Rust alternatives avoid.

Frequently Asked Questions

Related Projects

Qdrant

Qdrant - High-performance, massive-scale Vector Database and Vector Search Engine for the next generation of AI. Also available in the cloud https://cloud.qdrant.io/

Stars33,545

Forks2,520

Last commit21 hours ago

SurrealDB

A scalable, distributed, collaborative, document-graph database, for the realtime web

Stars32,748

Forks1,311

Last commit18 days ago

RustFS

🚀2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.

Stars30,153

Forks1,326

Last commit19 hours ago

Turso

A SQL database in Rust: SQLite-compatible, now also speaking Postgres (experimental). The LLVM of databases.

Stars23,381

Forks1,201

Last commit1 day ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub