Struct TableReader 

pub struct TableReader { /* private fields */ }

A typed global snapshot read proxy.

Implementations

impl TableReader

pub fn open(reader: Reader, name: impl Into<String>) -> Result<Self>

Open the snapshot carried by this core reader.

Readers opened from a core current-pointer reader check for later committed snapshots on its configured interval. Core fixed-snapshot readers remain fixed.

pub fn schema(&self) -> Arc<TableSchema>

Return the schema of this reader’s currently loaded global snapshot.

This accessor never checks CURRENT. A later fallible read may refresh a current-pointer reader; call Self::refresh before schema inspection when the latest committed snapshot is required.

pub fn key_builder(&self) -> TableKeyBuilder

Start building one primary key in schema order.

pub fn project_by_names<S: AsRef<str>>( &self, field_names: &[S], ) -> Result<TableProjection>

Compile a reusable read projection from top-level field names.

pub fn get(&self, key: &TableKey) -> Result<Option<Vec<Value>>>

Read one row by primary key.

pub fn multi_get(&self, keys: &[TableKey]) -> Result<Vec<Option<Vec<Value>>>>

Read many primary keys while preserving order and duplicates.

pub fn scan(&self, bucket: u16) -> Result<TableScan>

Scan all rows in one bucket.

pub fn scan_bounds( &self, bucket: u16, start_key_inclusive: Option<&TableKey>, end_key_exclusive: Option<&TableKey>, ) -> Result<TableScan>

Scan one bucket from an inclusive primary-key bound to an exclusive bound.

pub fn scan_plan(&self) -> Result<TableScanPlan>

Build a portable full-scan plan pinned to this reader’s current snapshot.

pub fn refresh(&self) -> Result<bool>

Refresh this current-pointer reader to the latest committed global snapshot.

Existing projections, scans, and scan plans retain their current fixed view. If the current pointer is unchanged, this returns false; an error leaves this reader unchanged. Fixed snapshot readers always return false.