Skip to main content

Module async_pool

voltdb_client_rust

Module async_pool

Expand description

Production-ready async connection pool for VoltDB.

§Features

Thread-safe with fine-grained locking
Connection state machine (Healthy, Unhealthy, Reconnecting)
Per-connection circuit breaker
Configurable exhaustion policy (FailFast or Block with async waiting)
Graceful shutdown with drain mode
Optional structured logging (tracing feature)
Optional metrics (metrics feature)

§Design

Pool lock only guards metadata (state, circuit breaker)
Each AsyncNode has its own lock for I/O operations
Network I/O never holds the pool lock

Structs§

AsyncPool: Thread-safe async connection pool for VoltDB.
AsyncPoolConfig: Async pool configuration.
AsyncPoolStats: Pool statistics snapshot.
AsyncPooledConn: A connection handle from the async pool.

Enums§

AsyncPoolError: Pool-specific error conditions.
Circuit: Per-connection circuit breaker state.
ConnState: Connection health state.
ExhaustionPolicy: What to do when all connections are busy.
ValidationMode: How to handle startup connection failures.