#cql #storage #nosql #array

cql_ i16

为CQL数据库提供i16存储支持 - 一个轻量级基于数组的数据库

1个不稳定版本

0.2.0 2020年3月22日

#2813数据库接口

MIT/Apache

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(())
}

更多信息

有关更多信息及更多示例,请参阅rustdocs。其他存储类型在cql_db crate中有所记录。

依赖关系

~120KB