Struct TableHandleCache 

pub struct TableHandleCache { /* private fields */ }

Held open-Dataset handles keyed by (table_path, branch, version, e_tag) — the version-keyed analogue of LanceDB’s DatasetConsistencyWrapper (rust/lancedb/src/table/dataset.rs). A warm read reuses a held handle with zero open IO (a cheap Dataset clone); a miss opens once at the location with the shared Session. Version plus e_tag are in the key, so a write (or a delete/recreate that reuses a version number on object stores with e_tags) is simply a new key. A same-branch manifest refresh clears this cache as the fallback for e_tag-less table locations. Only read-path Data opens use this — writes open HEAD directly and never receive a pinned handle.

Implementations

impl TableHandleCache

pub async fn invalidate_all(&self)

Drop all held handles. Correctness never requires this (version-in-key); it is memory hygiene, called from the same hooks that clear the graph index cache (branch switch / refresh).

pub async fn get_or_open( &self, table_path: &str, table_branch: Option<&str>, version: u64, e_tag: Option<&str>, location: &str, session: Option<&Arc<Session>>, ) -> Result<Dataset>

Return the dataset for (table_path, branch, version, e_tag), reusing a held handle (0 open IO) or opening it once at location with the shared session on a miss.

Trait Implementations

impl Default for TableHandleCache

fn default() -> TableHandleCache

Returns the “default value” for a type.