ScyllaDB Rust驱动程序

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

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

入门

《文档手册》是入门的好地方。另一个有用的资源是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
• Token感知路由
• 分片感知路由（特定于ScyllaDB）
• 预编译语句
• 查询分页
• 压缩（LZ4和Snappy算法）
• CQL二进制协议版本4
• 批处理语句
• 可配置的负载均衡策略
• 驱动程序端度量
• TLS支持 - 如果要使用它，请安装openssl https://docs.rs/openssl/0.10.32/openssl/#automatic
• 可配置的重试策略
• 身份验证支持
• CQL跟踪

持续努力

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

寻求帮助

请加入 ScyllaDB Slack 上的 #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 许可证 2.0 版，(LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。