Struct QueryBufferPool 

pub struct QueryBufferPool;

Thread-safe buffer pool for reusing allocations across query executions

Uses thread-local storage to eliminate lock contention. Each thread maintains its own pool of buffers, bounded at MAX_POOLED_BUFFERS entries.

Implementations

impl QueryBufferPool

pub fn new() -> Self

Create a new empty buffer pool

pub fn get_row_buffer(&self, min_capacity: usize) -> Vec<Row>

Get a row buffer from the pool, or create a new one

Returns a buffer with at least min_capacity capacity. The buffer will be empty but may have allocated capacity.

pub fn return_row_buffer(&self, buffer: Vec<Row>)

Return a row buffer to the pool for reuse

The buffer is cleared before being returned to the pool. If the pool is full, the buffer is dropped.

pub fn get_value_buffer(&self, min_capacity: usize) -> Vec<SqlValue>

Get a value buffer from the pool, or create a new one

Returns a buffer with at least min_capacity capacity. The buffer will be empty but may have allocated capacity.

pub fn return_value_buffer(&self, buffer: Vec<SqlValue>)

Return a value buffer to the pool for reuse

The buffer is cleared before being returned to the pool. If the pool is full, the buffer is dropped.

pub fn stats(&self) -> QueryBufferPoolStats

Get statistics about pool usage (for debugging/monitoring)

Returns stats for the current thread’s pool only.

pub fn clear_thread_local_pools()

Clear all thread-local buffer pools, releasing memory back to the allocator.

This is useful for benchmarks and long-running processes where memory pressure needs to be reduced between query batches. The pools will automatically refill as needed during subsequent query execution.

Example

use vibesql_storage::QueryBufferPool;

// Run a batch of queries...

// Clear pools to release memory
QueryBufferPool::clear_thread_local_pools();

Trait Implementations

impl Clone for QueryBufferPool

fn clone(&self) -> QueryBufferPool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryBufferPool

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

Formats the value using the given formatter.

impl Default for QueryBufferPool

fn default() -> QueryBufferPool

Returns the “default value” for a type.

impl Copy for QueryBufferPool