Struct ZerobusConfig 

pub struct ZerobusConfig {
    pub streams_per_table: usize,
    pub per_stream_mb_ceiling: f64,
    pub ack_channel_capacity: usize,
    pub max_in_flight_records: usize,
    pub preserve_order_by_partition: bool,
    pub server_ack_timeout: Duration,
    pub drain_budget: Duration,
    pub retry_backoff: Duration,
    pub max_ack_retries: u32,
    pub role: Role,
}

Sink configuration.

Fields

streams_per_table: usize

Pool size floor per target table; override to match bandwidth (§3.3).

per_stream_mb_ceiling: f64

The per-stream MB/s figure the derived pool size uses. Defaults to the Databricks-documented ~100 MB/s per-stream hard limit; set lower to leave headroom.

ack_channel_capacity: usize

Per-stream in-flight-unacked bound — the backpressure channel capacity.

max_in_flight_records: usize

SDK-side in-flight buffer target (≤ the SDK max, ~50k).

preserve_order_by_partition: bool

Preserve per-source-partition ordering: when true, all batches from one (topic, partition) are key-hashed to a fixed stream (Zerobus guarantees order within a stream); when false, batches round-robin across the pool.

This is partition-granular, not record-granular: a per-column ordering key cannot be honoured at batch granularity (a batch holds many rows with different key values), so ordering is preserved at the unit the source already partitions by.

server_ack_timeout: Duration

Per-ack deadline. Not a throughput knob — pipelining is.

drain_budget: Duration

Graceful teardown budget on poison / shutdown.

retry_backoff: Duration

Backoff applied before retrying a transient ack failure on the existing stream.

max_ack_retries: u32

Maximum consecutive transient retries before a burst is treated as poison.

role: Role

The sink’s role.

Implementations

impl ZerobusConfig

pub fn derive_pool_size(&self, peak_mb_per_s: f64) -> usize

Derive the pool size for a table from its peak bandwidth (§3.3): ceil(peak_MB_per_s / per_stream_mb_ceiling), floored at the configured minimum and at 1. Sizing is by bytes, so large-record tables get more streams at a lower record rate.

Trait Implementations

impl Clone for ZerobusConfig

fn clone(&self) -> ZerobusConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ZerobusConfig

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

Formats the value using the given formatter.

impl Default for ZerobusConfig

fn default() -> Self

Returns the “default value” for a type.