Struct Database 

pub struct Database { /* private fields */ }

A cloneable handle to an embedded Basalt database.

Implementations

impl Database

pub fn in_memory() -> Database

Create an empty, non-durable database.

pub fn open(path: impl AsRef<Path>) -> Result<Database, DbError>

Open or create a durable database at path.

pub fn begin(&self) -> Result<Transaction, DbError>

Begin an optimistic snapshot transaction.

pub fn transaction(&self) -> Result<Transaction, DbError>

Alias for Database::begin using the conventional transaction name.

pub fn connect(&self) -> Connection

Create a stateful connection. Connections are useful when SQL BEGIN, COMMIT, and ROLLBACK statements span multiple calls.

pub fn execute(&self, stmt: &Statement) -> Result<StatementResult, DbError>

Execute one statement as an autocommit operation.

pub fn execute_sql(&self, sql: &str) -> Result<Vec<StatementResult>, DbError>

Parse and execute all statements through a fresh autocommit connection.

pub fn checkpoint(&self) -> Result<(), DbError>

Flush the current state into the page file and clear committed WAL frames. Checkpointing is safe while readers are active.

pub fn generation(&self) -> u64

Current committed generation, useful for diagnostics and tests.

pub fn table_names(&self) -> Result<Vec<String>, DbError>

Return table names in deterministic order for schema discovery tools.

pub fn columns(&self, table: &str) -> Result<Vec<Column>, DbError>

Return a table’s column metadata for migrations and introspection.

pub fn row_count(&self, table: &str) -> Result<usize, DbError>

Return the number of live rows in a table without materializing them.

Trait Implementations

impl Clone for Database

fn clone(&self) -> Database

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.