Struct SinkParts 

#[non_exhaustive]
pub struct SinkParts<W>
where
    W: ShardWriter,
{
    pub writer: W,
    pub shard_endpoints: Vec<Vec<<W as ShardWriter>::Endpoint>>,
    pub pool: SinkPoolConfig,
    pub component_type: String,
    pub replica_labels: Vec<Vec<String>>,
    pub probe: Option<Box<dyn Fn() -> Pin<Box<dyn Future<Output = Result<(), SinkError>> + Send>> + Sync + Send>>,
}

The decomposed sink. Construct with SinkParts::new and refine with the with_* methods (the struct is #[non_exhaustive]; fields may be added without breaking implementors).

shard_endpoints is indexed [shard][replica] and must be non-empty with every shard holding at least one replica — the builder rejects ragged or empty topologies before anything spawns.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

writer: W

The connector’s writer, shared by every shard worker.

shard_endpoints: Vec<Vec<<W as ShardWriter>::Endpoint>>

Per-shard replica endpoints, [shard][replica].

pool: SinkPoolConfig

Pool tuning (batching, inflight, retry, breaker).

component_type: String

The component_type metric label (e.g. "clickhouse").

replica_labels: Vec<Vec<String>>

Per-replica display labels for shard metrics, same shape as shard_endpoints. Defaults to "{component_type}-{shard}-{replica}".

probe: Option<Box<dyn Fn() -> Pin<Box<dyn Future<Output = Result<(), SinkError>> + Send>> + Sync + Send>>

Optional readiness probe. Probes should use their own client set — sharing the writer’s connections would report the insert path healthy simply because probing keeps it warm.

Implementations

impl<W> SinkParts<W>

where W: ShardWriter,

pub fn new( writer: W, shard_endpoints: Vec<Vec<<W as ShardWriter>::Endpoint>>, pool: SinkPoolConfig, ) -> SinkParts<W>

Minimal parts: component_type defaults to "custom", replica labels to "{component_type}-{shard}-{replica}", no probe.

pub fn with_component_type( self, component_type: impl Into<String>, ) -> SinkParts<W>

Set the component_type metric label.

pub fn with_replica_labels(self, labels: Vec<Vec<String>>) -> SinkParts<W>

Set per-replica display labels (same [shard][replica] shape as the endpoints).

pub fn with_probe( self, probe: Box<dyn Fn() -> Pin<Box<dyn Future<Output = Result<(), SinkError>> + Send>> + Sync + Send>, ) -> SinkParts<W>

Attach a readiness probe.

pub fn effective_replica_labels(&self) -> Vec<Vec<String>>

The replica labels to use: the configured ones, or the "{component_type}-{shard}-{replica}" defaults. Manual assemblies can feed these to SinkShardMetrics::new.

Trait Implementations

impl<W> Debug for SinkParts<W>

where W: ShardWriter,

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

Formats the value using the given formatter.

impl<W> SinkBundle for SinkParts<W>

where W: ShardWriter,

type Writer = W

The connector’s ShardWriter implementation.

fn into_parts(self) -> SinkParts<W>

Decompose into the parts the builder wires up. Consuming: the endpoints move into the sink pool.