Struct ColumnarTable 

pub struct ColumnarTable { /* private fields */ }

Columnar table storage

Stores data in column-oriented format for analytical query performance. Each column is stored as a typed vector with a separate NULL bitmap.

Example

use vibesql_storage::{Row, ColumnarTable};
use vibesql_types::SqlValue;

// Create rows
let rows = vec![
    Row::new(vec![SqlValue::Integer(1), SqlValue::Double(3.14)]),
    Row::new(vec![SqlValue::Integer(2), SqlValue::Double(2.71)]),
];

// Convert to columnar
let column_names = vec!["id".to_string(), "value".to_string()];
let columnar = ColumnarTable::from_rows(&rows, &column_names).unwrap();

// Access column data
assert_eq!(columnar.row_count(), 2);
assert_eq!(columnar.column_count(), 2);

Implementations

impl ColumnarTable

pub fn new() -> Self

Create a new empty columnar table

pub fn from_rows(rows: &[Row], column_names: &[String]) -> Result<Self, String>

Convert row-oriented data to columnar format (optimized single-pass)

Arguments

• rows - Vector of rows to convert
• column_names - Names of columns in order

Returns

• Ok(ColumnarTable) on success
• Err(String) if column count mismatch or incompatible types

Performance

O(n * m) single pass through all data

pub fn from_row_refs( rows: &[&Row], column_names: &[String], ) -> Result<Self, String>

Create a ColumnarTable from a slice of row references

This is useful when you have filtered rows (e.g., skipping deleted rows) and want to avoid cloning the entire row just to pass to from_rows.

Arguments

• rows - Slice of row references to convert
• column_names - Column names for the table schema

Returns

• Ok(ColumnarTable) on success
• Err(String) if column count mismatch or incompatible types

pub fn to_rows(&self) -> Vec<Row>

Convert columnar data back to row-oriented format

Returns

Vector of rows reconstructed from columnar data

Performance

O(n * m) where n = rows, m = columns

pub fn row_count(&self) -> usize

Get the number of rows

pub fn column_count(&self) -> usize

Get the number of columns

pub fn get_column(&self, name: &str) -> Option<&ColumnData>

Get column data by name

pub fn column_names(&self) -> &[String]

Get all column names

pub fn size_in_bytes(&self) -> usize

Estimate the memory size of this columnar table in bytes

This is used for memory budgeting in the columnar cache. The estimate includes:

• All column data (via ColumnData::size_in_bytes)
• HashMap overhead for columns
• Vec overhead for column_names
• String storage for column names

Trait Implementations

impl Clone for ColumnarTable

fn clone(&self) -> ColumnarTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColumnarTable

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ColumnarTable

fn default() -> Self

Returns the “default value” for a type.