Struct InstanceCache 

pub struct InstanceCache { /* private fields */ }

RAII wrapper for a duckdb_instance_cache.

Automatically destroyed when dropped. Databases obtained from the cache remain valid until they are individually closed and the cache is dropped.

Implementations

impl InstanceCache

pub fn new() -> Self

Creates a new, empty instance cache.

pub fn get_or_create( &self, path: &CStr, config: Option<&DbConfig>, ) -> Result<duckdb_database, ExtensionError>

Opens path through the cache, creating the instance if it does not yet exist or returning a handle to the cached one if it does.

Pass config to control how a freshly-created instance is configured; it is ignored when an instance already exists for path.

The returned duckdb_database is owned by the caller and must be closed with duckdb_close when no longer needed.

Errors

Returns an ExtensionError carrying DuckDB’s message if the instance cannot be opened or created.

pub const fn as_raw(&self) -> duckdb_instance_cache

Returns the raw handle.

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.