Struct VirtualDataSlice 

pub struct VirtualDataSlice { /* private fields */ }

A columnar data slice returned from a virtual server view query.

This struct represents a rectangular slice of data from a view, stored internally as Arrow builders during population and frozen into a RecordBatch on first consumption.

Implementations

impl VirtualDataSlice

pub fn new(config: ViewConfig) -> Self

pub fn from_arrow_ipc(&mut self, ipc: &[u8]) -> Result<(), Box<dyn Error>>

Loads data from Arrow IPC file format bytes, with automatic post-processing based on the view configuration.

When group_by is active, extracts __GROUPING_ID__ and __ROW_PATH_N__ columns to build self.row_path, then removes __GROUPING_ID__ from the output RecordBatch. The __ROW_PATH_N__ columns are kept in the frozen batch so downstream Arrow IPC consumers (with_typed_arrays, used by viewer-charts to drive its categorical/numeric axis resolvers and tree-hierarchy walkers) see them inline — matching the native perspective-server’s to_arrow output when emit_legacy_row_path_names: false.

When split_by is active, renames data columns by replacing _ with | (the DuckDB PIVOT separator).

Also coerces non-standard Arrow types (e.g. Decimal128, Int64) to Perspective-compatible types.

pub fn render_to_columns_json( &mut self, style: RowPathStyle, ) -> Result<String, Box<dyn Error>>

Serializes the data to a column-oriented JSON string.

style selects between the legacy __ROW_PATH__ sidecar (Sidecar, used by to_columns) and the native per-level __ROW_PATH_N__ columns (PerLevel, currently unused — reserved for the future deprecation of __ROW_PATH__). See RowPathStyle for context.

pub fn set_col<T: SetVirtualDataColumn>( &mut self, name: &str, grouping_id: Option<usize>, index: usize, value: T, ) -> Result<(), Box<dyn Error>>

Sets a value in a column at the specified row index.

If group_by_index is Some, the value is added to the __ROW_PATH__ column as part of the row’s group-by path. Otherwise, the value is inserted into the named column.

Creates the column if it does not already exist.

Trait Implementations

impl Debug for VirtualDataSlice

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

Formats the value using the given formatter.