77 releases (36 breaking)

0.36.0 Apr 25, 2024
0.34.0 Mar 10, 2024
0.32.0 Nov 8, 2023
0.31.0 Jun 18, 2023
0.14.2 Jul 31, 2015

#15 in Database interfaces

Download history 6565/week @ 2024-01-31 7412/week @ 2024-02-07 6013/week @ 2024-02-14 6647/week @ 2024-02-21 6064/week @ 2024-02-28 6817/week @ 2024-03-06 7501/week @ 2024-03-13 9581/week @ 2024-03-20 8753/week @ 2024-03-27 6137/week @ 2024-04-03 7045/week @ 2024-04-10 8826/week @ 2024-04-17 9073/week @ 2024-04-24 8900/week @ 2024-05-01 7350/week @ 2024-05-08 5168/week @ 2024-05-15

32,435 downloads per month
Used in 286 crates (68 directly)

Apache-2.0 OR MIT

55KB
1K SLoC

SQLite Package Documentation Build

The package provides an interface to SQLite.

Example

Open a connection, create a table, and insert a few rows:

let connection = sqlite::open(":memory:").unwrap();

let query = "
    CREATE TABLE users (name TEXT, age INTEGER);
    INSERT INTO users VALUES ('Alice', 42);
    INSERT INTO users VALUES ('Bob', 69);
";
connection.execute(query).unwrap();

Select some rows and process them one by one as plain text, which is generally not efficient:

let query = "SELECT * FROM users WHERE age > 50";

connection
    .iterate(query, |pairs| {
        for &(name, value) in pairs.iter() {
            println!("{} = {}", name, value.unwrap());
        }
        true
    })
    .unwrap();

Run the same query but using a prepared statement, which is much more efficient than the previous technique:

use sqlite::State;

let query = "SELECT * FROM users WHERE age > ?";
let mut statement = connection.prepare(query).unwrap();
statement.bind((1, 50)).unwrap();

while let Ok(State::Row) = statement.next() {
    println!("name = {}", statement.read::<String, _>("name").unwrap());
    println!("age = {}", statement.read::<i64, _>("age").unwrap());
}

Run the same query but using a cursor, which is iterable:

let query = "SELECT * FROM users WHERE age > ?";

for row in connection
    .prepare(query)
    .unwrap()
    .into_iter()
    .bind((1, 50))
    .unwrap()
    .map(|row| row.unwrap())
{
    println!("name = {}", row.read::<&str, _>("name"));
    println!("age = {}", row.read::<i64, _>("age"));
}

Contribution

Your contribution is highly appreciated. Do not hesitate to open an issue or a pull request. Note that any contribution submitted for inclusion in the project will be licensed according to the terms given in LICENSE.md.

Dependencies

~0.2–1.7MB
~35K SLoC