Rusqlite

Rusqlite 是从 Rust 使用 SQLite 的舒适包装。

历史上，API 是基于 rust-postgres 的。然而，这两个项目在很多方面都发生了分歧，并且不打算在它们之间提供兼容性。

用法

在您的 Cargo.toml 中

[dependencies]
# `bundled` causes us to automatically compile and link in an up to date
# version of SQLite for you. This avoids many common build issues, and
# avoids depending on the version of SQLite on the users system (or your
# system), which may be old or missing. It's the right choice for most
# programs that control their own SQLite databases.
#
# That said, it's not ideal for all scenarios and in particular, generic
# libraries built around `rusqlite` should probably not enable it, which
# is why it is not a default feature -- it could become hard to disable.
rusqlite = { version = "0.28.0", features = ["bundled"] }

简单示例用法

use rusqlite::{Connection, Result};

#[derive(Debug)]
struct Person {
    id: i32,
    name: String,
    data: Option<Vec<u8>>,
}

fn main() -> Result<()> {
    let conn = Connection::open_in_memory()?;

    conn.execute(
        "CREATE TABLE person (
            id    INTEGER PRIMARY KEY,
            name  TEXT NOT NULL,
            data  BLOB
        )",
        (), // empty list of parameters.
    )?;
    let me = Person {
        id: 0,
        name: "Steven".to_string(),
        data: None,
    };
    conn.execute(
        "INSERT INTO person (name, data) VALUES (?1, ?2)",
        (&me.name, &me.data),
    )?;

    let mut stmt = conn.prepare("SELECT id, name, data FROM person")?;
    let person_iter = stmt.query_map([], |row| {
        Ok(Person {
            id: row.get(0)?,
            name: row.get(1)?,
            data: row.get(2)?,
        })
    })?;

    for person in person_iter {
        println!("Found person {:?}", person.unwrap());
    }
    Ok(())
}

支持的 SQLite 版本

基础 rusqlite 包支持 SQLite 版本 3.6.8 或更高版本。如果您需要支持旧版本，请提交一个问题。某些 cargo 功能需要更高版本的 SQLite；请参见下文详情。

可选功能

Rusqlite 提供了几个在 Cargo 功能 之后的特性。它们是：

• load_extension 允许加载基于动态库的 SQLite 扩展。
• backup 允许使用 SQLite 的在线备份 API。注意：此功能需要 SQLite 3.6.11 或更高版本。
• functions 允许您将 Rust 闭包加载到 SQLite 连接中用于查询。注意：此功能需要 SQLite 3.7.3 或更高版本。
• window 用于 窗口函数 支持 (fun(...) OVER ...)。 (隐含 functions)
• trace 允许钩子操作 SQLite 的跟踪和性能分析 API。注意：此功能需要 SQLite 3.6.23 或更高版本。
• blob 提供了对 SQL BLOB 的 std::io::{Read, Write, Seek} 访问。注意：此功能需要 SQLite 3.7.4 或更高版本。
• limits 允许您设置和检索 SQLite 的每连接限制。
• chrono 实现了 FromSql 和 ToSql 接口，用于 chrono 库 中的多种类型。
• serde_json 实现了 FromSql 和 ToSql 接口，用于 serde_json 库 中的 Value 类型。
• time 实现了 FromSql 和 ToSql 接口，用于 time 库 中的 time::OffsetDateTime 类型。
• url 实现了 FromSql 和 ToSql 接口，用于 url 库 中的 Url 类型。
• bundled 使用了捆绑版的 SQLite。在连接 SQLite 复杂的情况下，如 Windows，这是一个不错的选择。
• sqlcipher 寻找 SQLCipher 库进行链接，而不是 SQLite。此功能覆盖了 bundled。
• bundled-sqlcipher 使用了捆绑版的 SQLCipher。它搜索并链接到一个系统安装的加密库，以提供加密实现。
• bundled-sqlcipher-vendored-openssl 允许使用捆绑的 SQLCipher 和由 OpenSSL（通过 openssl-sys 库）提供的版本作为加密提供者。
  • 正如其名所示，这依赖于 bundled-sqlcipher 功能，并且会自动开启它。
  • 如果开启，这将使用 openssl-sys 库，并启用 vendored 功能以构建和捆绑 OpenSSL 加密库。
• hooks 用于 提交、回滚 和 数据更改 通知回调。
• unlock_notify 用于 解锁 通知。
• vtab 用于 虚拟表 支持（允许你在 Rust 中编写虚拟表实现）。目前仅支持只读虚拟表。
• series 提供了 generate_series() 表值函数。（隐含 vtab。）
• csvtab，用 Rust 编写的 CSV 虚拟表。（隐含 vtab。）
• array，rarray() 表值函数。（隐含 vtab。）
• i128_blob 允许在 SQLite 数据库中存储类型为 i128 的值。内部，数据以 16 字节的大端 blob 存储并翻转最高位，这使得不同 blob 存储的 i128 值的排序和比较能够按预期工作。
• uuid 允许使用 blob 存储和检索 Uuid 值，该功能通过 uuid 包实现。
• session，Session 模块扩展。需要 buildtime_bindgen 功能。（隐含 hooks。）
• extra_check 当执行查询时，如果查询是只读的或者列数大于 0，则会失败。
• column_decltype 为语句和行提供 columns() 方法；如果链接到使用 -DSQLITE_OMIT_DECLTYPE 编译的 SQLite/SQLCipher 版本，则省略。
• collation 提供了 sqlite3_create_collation_v2。
• winsqlite3 允许链接到 Windows 新版本中现有的 SQLite。