ScyllaDB Rust 驱动

这是一个用纯 Rust 编写的 ScyllaDB 客户端驱动程序，具有使用 Tokio 的完全异步 API。虽然针对 ScyllaDB 进行了优化，但此驱动程序也与 Apache Cassandra® 兼容。

注意：此驱动程序官方支持，但目前处于测试版。欢迎提交错误报告和拉取请求！

入门

《文档书籍》是入门的好地方。另一个有用的资源是 Scylla University 上的 Rust 和 Scylla 课程。

示例

let uri = "127.0.0.1:9042";

let session: Session = SessionBuilder::new().known_node(uri).build().await?;

let result = session.query("SELECT a, b, c FROM ks.t", &[]).await?;
let mut iter = result.rows_typed::<(i32, i32, String)>()?;
while let Some((a, b, c)) = iter.next().transpose()? {
    println!("a, b, c: {}, {}, {}", a, b, c);
}

请参阅完整的 示例程序 获取更多信息。如果您有一个正在运行的 Scylla 服务器，也可以按以下方式运行示例

SCYLLA_URI="127.0.0.1:9042" cargo run --example basic

所有示例都可在 示例目录 中找到

功能和路线图

驱动程序支持以下功能

• 异步 API
• 令牌感知路由
• 分片感知路由（特定于 ScyllaDB）
• 预处理语句
• 查询分页
• 压缩（LZ4 和 Snappy 算法）
• CQL 二进制协议版本 4
• 批处理语句
• 可配置的负载均衡策略
• 驱动程序端度量
• TLS 支持 - 如果要使用它，请安装 openssl https://docs.rs/openssl/0.10.32/openssl/#automatic
• 可配置的重试策略
• 身份验证支持
• CQL 跟踪

正在进行的工作

• CQL 事件
• 更多测试
• 更多基准测试

获取帮助

请加入 #rust-driver 频道，在 ScyllaDB Slack 上讨论您可能遇到的任何问题或疑问。

支持的 Rust 版本

我们驱动程序的最小支持 Rust 版本 (MSRV) 是 1.66.0。任何更改都将明确公布，并且仅在主要版本发布时发生。

参考文档

• CQL 二进制协议 第 4 版规范

其他驱动程序

• cdrs-tokio：使用纯 Rust 编写的 Apache Cassandra 驱动程序。
• cassandra-rs：Apache Cassandra 的 DataStax C++ 驱动程序的 Rust 封装。DataStax C++ driver

许可

此项目受以下之一许可：

• Apache License，版本 2.0，（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT 许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

您可选。