Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/krojew/cdrs-tokio
High-level async Cassandra client written in 100% Rust.
https://github.com/krojew/cdrs-tokio
cassandra driver rust
Last synced: about 1 month ago
JSON representation
High-level async Cassandra client written in 100% Rust.
- Host: GitHub
- URL: https://github.com/krojew/cdrs-tokio
- Owner: krojew
- License: apache-2.0
- Created: 2020-11-17T06:14:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T13:18:47.000Z (about 1 month ago)
- Last Synced: 2024-04-25T14:34:21.109Z (about 1 month ago)
- Topics: cassandra, driver, rust
- Language: Rust
- Homepage:
- Size: 2.16 MB
- Stars: 124
- Watchers: 7
- Forks: 24
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
Lists
- awesome-rust - krojew/cdrs-tokio - level async Cassandra client written in 100% Rust. [](https://github.com/krojew/cdrs-tokio/actions) (Libraries / Database)
- awesome-rust-cn - krojew/cdrs-tokio - tokio](https://crates.io/crates/cdrs-tokio)] (库 Libraries / 数据库 Database)
README
# CDRS tokio
[](https://crates.io/crates/cdrs-tokio)  
CDRS is production-ready Apache **C**assandra **d**river written in pure **R**u**s**t. Focuses on providing high
level of configurability to suit most use cases at any scale, as its Java counterpart, while also leveraging the
safety and performance of Rust.
## Features
- Asynchronous API;
- TCP/TLS connection (rustls);
- Topology-aware dynamic and configurable load balancing;
- Configurable connection strategies and pools;
- Configurable speculative execution;
- LZ4, Snappy compression;
- Cassandra-to-Rust data serialization/deserialization with custom type support;
- Pluggable authentication strategies;
- [ScyllaDB](https://www.scylladb.com/) support;
- Server events listening;
- Multiple CQL version support (3, 4, 5), full spec implementation;
- Query tracing information;
- Prepared statements;
- Query paging;
- Batch statements;
- Configurable retry and reconnection policy;
- Support for interleaved queries;
- Support for Yugabyte YCQL JSONB;
- Support for beta protocol usage;
## Performance
Due to high configurability of **CDRS**, the performance will vary depending on use case. The following benchmarks
have been made against the latest (master as of 03-12-2021) versions of respective libraries (except
cassandra-cpp: 2.16.0) and protocol version 4.
- `cdrs-tokio-large-pool` - **CDRS** with node connection pool equal to double of physical CPU cores
- `cdrs-tokio-small-pool` - **CDRS** with a single connection per node
- `scylladb-rust-large-pool` - `scylla` crate with node connection pool equal to double of physical CPU cores
- `scylladb-rust-small-pool` - `scylla` crate with a single connection per node
- `cassandra-cpp` - Rust bindings for Datastax C++ Driver, running on multiple threads using Tokio
- `gocql` - a driver written in Go
Knowing given use case, CDRS can be optimized for peak performance.
## Documentation and examples
- [User guide](./documentation).
- [Examples](./cdrs-tokio/examples).
- [API docs](https://docs.rs/cdrs-tokio/latest/cdrs_tokio/).
- Using ScyllaDB with RUST [lesson](https://university.scylladb.com/courses/using-scylla-drivers/lessons/rust-and-scylla/).
## Getting started
This example configures a cluster consisting of a single node without authentication, and uses round-robin
load balancing. Other options are kept as default.
```rust
use cdrs_tokio::cluster::session::{TcpSessionBuilder, SessionBuilder};
use cdrs_tokio::cluster::NodeTcpConfigBuilder;
use cdrs_tokio::load_balancing::RoundRobinLoadBalancingStrategy;
use cdrs_tokio::query::*;
#[tokio::main]
async fn main() {
let cluster_config = NodeTcpConfigBuilder::new()
.with_contact_point("127.0.0.1:9042".into())
.build()
.await
.unwrap();
let session = TcpSessionBuilder::new(RoundRobinLoadBalancingStrategy::new(), cluster_config)
.build()
.await
.unwrap();
let create_ks = "CREATE KEYSPACE IF NOT EXISTS test_ks WITH REPLICATION = { \
'class' : 'SimpleStrategy', 'replication_factor' : 1 };";
session
.query(create_ks)
.await
.expect("Keyspace create error");
}
```
## License
This project is licensed under either of
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))
- MIT license ([LICENSE-MIT](LICENSE-MIT) or [http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))
at your option.