Struct InstanceCache 

pub struct InstanceCache { /* private fields */ }

An owned duckdb_instance_cache (destroyed once on drop).

Deliberately !Send + !Sync: DuckDB gives no concurrency guarantee for a shared instance cache, so a handle must stay on the thread that created it.

Implementations

impl InstanceCache

pub fn new() -> InstanceCache

Creates a new, empty instance cache.

pub fn get_or_create<P: AsRef<Path>>( &self, path: P, config: Config, ) -> Result<Database>

Opens the database at path through this cache: if a database for path already exists in the cache it is returned (sharing the same instance), otherwise a new one is created and cached. :memory: and an empty path both mean an in-memory database.

The returned Database closes independently; the cache keeps its own reference until dropped.

Errors

Returns an error if the path contains an interior NUL or DuckDB fails to open the database (its error message is surfaced).

Trait Implementations

impl Default for InstanceCache

fn default() -> Self

Returns the “default value” for a type.

impl Drop for InstanceCache

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.