perf: reuse executors and resolve tables by id to close the TPC-C gap with SQLite

.github/workflows/ci.yml

@@ -45,6 +45,10 @@ jobs:
       - uses: dtolnay/rust-toolchain@stable
         with:
           components: clippy
+      # `--all-features` builds the pyo3 bindings, which need a supported Python.
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
       - uses: Swatinem/rust-cache@v2
 
       - name: Run cargo clippy

Cargo.toml

@@ -2,9 +2,8 @@
 
 [package]
 name          = "kite_sql"
-version       = "0.6.0"
+version       = "0.6.1"
 edition       = "2021"
-build         = "build.rs"
 authors       = ["Kould <kould2333@gmail.com>", "Xwg <loloxwg@gmail.com>"]
 description   = "SQL as a Function for Rust"
 documentation = "https://docs.rs/kite_sql/latest/kite_sql/"
@@ -33,7 +32,7 @@ macros  = []
 orm     = ["macros"]
 parser  = ["dep:sqlparser"]
 rocksdb = ["dep:rocksdb"]
-unsafe_txdb_checkpoint = ["rocksdb", "dep:librocksdb-sys"]
+unsafe_txdb_checkpoint = ["rocksdb"]
 lmdb    = ["dep:lmdb", "dep:lmdb-sys"]
 pprof   = ["pprof/criterion", "pprof/flamegraph"]
 python  = ["parser", "dep:pyo3"]
@@ -57,7 +56,7 @@ required-features = ["pprof"]
 bumpalo               = { version = "3", default-features = false, features = ["collections"] }
 ordered-float         = { version = "4" }
 paste                 = { version = "1" }
-kite_sql_serde_macros = { version = "0.2.5", path = "kite_sql_serde_macros" }
+kite_sql_serde_macros = { version = "0.2.6", path = "kite_sql_serde_macros" }
 
 # Optional dependencies for features
 comfy-table           = { version = "7", default-features = false, optional = true }
@@ -79,10 +78,9 @@ sqlite                = { version = "0.34" }
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 # Optional dependencies for features
-librocksdb-sys = { version = "0.17.1", optional = true }
 lmdb = { version = "0.8.0", optional = true }
 lmdb-sys = { version = "0.8.0", optional = true }
-rocksdb = { version = "0.23", optional = true, default-features = false, features = ["bindgen-runtime"] }
+rocksdb = { version = "0.25", optional = true, default-features = false, features = ["bindgen-runtime"] }
 rustyline = { version = "14", default-features = false, optional = true }
 
 [target.'cfg(target_arch = "wasm32")'.dependencies]

Makefile

@@ -169,3 +169,4 @@ wasm-examples:
 native-examples:
 	$(CARGO) run --example hello_world
 	$(CARGO) run --example transaction
+	$(CARGO) run --example program

README.md

@@ -85,7 +85,7 @@ fn main() -> Result<(), DatabaseError> {
 }
 ```
 
-More: [hello_world](examples/hello_world.rs), [transaction](examples/transaction.rs).
+More: [hello_world](examples/hello_world.rs), [transaction](examples/transaction.rs), [program](examples/program.rs).
 
 ## Storage Backends
 | Builder | Storage |
@@ -95,7 +95,7 @@ More: [hello_world](examples/hello_world.rs), [transaction](examples/transaction
 | `build_in_memory()` | In-memory, for tests and temporary data |
 | `build_optimistic()` | RocksDB with optimistic transactions |
 
-Feature flags, checkpoints, and transaction isolation: [docs/features.md](docs/features.md), [docs/transaction-isolation.md](docs/transaction-isolation.md).
+Feature flags, checkpoints, and transaction isolation: [docs/features.md](docs/features.md).
 
 ## Shell, WebAssembly, Python
 
@@ -135,9 +135,9 @@ print(list(db.run("select * from demo")))
 
 | Backend | TpmC | New-Order | Payment | Order-Status | Delivery | Stock-Level |
 | --- | ---: | ---: | ---: | ---: | ---: | ---: |
-| KiteSQL LMDB | 165956 | 303 | 75 | 43 | 436 | 318 |
-| KiteSQL RocksDB | 50739 | 392 | 188 | 198 | 11743 | 812 |
-| SQLite (WAL, `synchronous=OFF`) | 191484 | 274 | 41 | 33 | 343 | 268 |
+| KiteSQL LMDB | 187161 | 274 | 68 | 40 | 454 | 278 |
+| KiteSQL RocksDB | 46291 | 374 | 184 | 201 | 14463 | 651 |
+| SQLite (WAL, `synchronous=OFF`) | 179039 | 291 | 43 | 38 | 368 | 320 |
 
 👉 [Details and how to reproduce](tpcc/README.md)
 

docs/features.md

@@ -149,14 +149,14 @@ let kite_sql = DataBaseBuilder::path("./data")
 ### MVCC Transaction
 - Pessimistic (Default)
 - Optimistic
-- Isolation levels: see [Transaction Isolation](transaction-isolation.md)
+- Isolation level: repeatable read; every statement in a transaction reads the snapshot taken when it began
 
 ### Checkpoint
 KiteSQL exposes checkpoint as a storage capability rather than a full backup workflow. A checkpoint only creates a consistent local snapshot directory; compressing, uploading, retaining, and pruning backups should stay in application code.
 
 Support matrix:
 - `build_optimistic()` supports `Database::checkpoint(...)` through RocksDB's safe checkpoint API.
-- `build_rocksdb()` requires Cargo feature `unsafe_txdb_checkpoint` because upstream `rocksdb` does not currently expose a safe `TransactionDB` checkpoint API.
+- `build_rocksdb()` requires Cargo feature `unsafe_txdb_checkpoint`, which uses RocksDB's `TransactionDB` checkpoint API.
 - `build_lmdb()` and `build_in_memory()` do not currently expose checkpoint support.
 
 Opt in for `TransactionDB` checkpoint support: