1个不稳定版本
0.2.0 | 2020年3月22日 |
---|
#2813 在 数据库接口
17KB
80 行
CQL I16
此crate实现了存储CQL数据库中i16值的各种CqlType派生。
每个值将分配2个字节链接。
基准测试
以下提供的基准测试相对基础(且已四舍五入),仅供参考相对成本。完整的基准测试代码可在github中找到,并可以使用rustup run nightly cargo bench
运行。
操作 | 数据库维度 | 平均时间 _unchecked (ns) |
---|---|---|
单点读取 | 1 | 2 520 (+/- 200) |
单点读取 | 4 | 15 300 (+/- 1 100) |
单点写入 | 1 | 2 800 (+/- 300) |
单点写入 | 4 | 15 350 (+/- 1 500) |
流读取1点 | 1 | 2 500 (+/- 200) |
流读取1点 | 4 | 15 400 (+/- 850) |
流读取50,000点 | 1 | 27 600 000 (+/- 900 000) |
流读取50,000点 | 4 | 27 400 000 (+/- 90 000) |
入门指南
要开始,请将以下依赖项添加到您的Cargo.toml中
[dependencies]
//... (any existing dependencies you may have)
cql_db = "^0.2.4"
cql_i16 = "^0.2"
然后需要创建一个文件夹,其中包含数据库所在位置,然后尝试以下操作
use std::io::{ Cursor, SeekFrom, Seek };
use cql_db::error::Error;
use cql_i16::{ I16, unpack_stream };
const DATABASE_LOCATION: &str = "PATH_TO_YOUR_DATABASE_DIRECTORY";
pub fn example_cql() -> Result<(), Error> {
// create a one dimensional database to hold 3 points
cql_db::create_db::<I16>(
DATABASE_LOCATION,
&[3]
)?;
// write '1', to [1]
cql_db::write_value::<U64>(
DATABASE_LOCATION,
&[1],
1
)?;
let mut result = [0; 2];
let mut stream = Cursor::new(Vec::new());
// read 2 values from [1] to 'stream'
cql_db::read_to_stream::<I16>(
DATABASE_LOCATION,
&mut stream,
&[1],
2
)?;
stream.seek(SeekFrom::Start(0)).unwrap();
unpack_stream(&mut stream, 2, |idx, value| {
result[idx] = value
})?;
assert_eq!(result[0], 1);
assert_eq!(result[1], 0);
Ok(())
}
更多信息
依赖关系
~120KB