tank-duckdb 0.42.0

DuckDB driver implementation for Tank: the Rust data layer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

<div align="center">
    <img width="300" height="300" src="../docs/public/logo.png" alt="Tank logo: a circular gold emblem with a military tank and a database symbol" />
</div>

# tank-duckdb

DuckDB driver implementation for [Tank](https://crates.io/crates/tank): the Rust data layer.

Implements Tank’s `Driver` and related traits for DuckDB, mapping Tank operations and queries into direct DuckDB commands. It does not replace the main [`tank`](https://crates.io/crates/tank) crate. you still use it to define entities, manage schemas, and build queries.

📘 https://tankhq.github.io/tank

🖥️ https://github.com/TankHQ/tank

📦 https://crates.io/crates/tank

## Features
- DuckDB C API (FFI) using [libduckdb-sys](https://crates.io/crates/libduckdb-sys)
- Bulk inserts use DuckDB's appender API
- Queries are executed in parallel using [tokio](https://crates.io/crates/tokio) runtime, results are send using [flume](https://crates.io/crates/flume) unbounded channel

## Install
```sh
cargo add tank
cargo add tank-duckdb
```

Optional feature flags:
- `bundled` (default): uses the bundled DuckDB library.

Disable it if you want a system DuckDB:
```sh
cargo add tank-duckdb --no-default-features
```

## Quick Start
```rust
use tank::{ConnectionPool, Driver, PoolConfig};
use tank_duckdb::DuckDBDriver;

let driver = DuckDBDriver::new();
let pool = driver
    .connect_pool("duckdb://path/to/database.duckdb?mode=rw".into(), PoolConfig::new())
    .await?;
let mut connection = pool.get().await?;
```