Struct ObjectStoreCheckpointer 

pub struct ObjectStoreCheckpointer { /* private fields */ }

Production Checkpointer backed by an [ObjectStore].

Supports concurrent partition uploads and SHA-256 integrity verification.

Implementations

impl ObjectStoreCheckpointer

pub fn new( store: Arc<dyn ObjectStore>, paths: CheckpointPaths, max_concurrent_uploads: usize, ) -> Self

Create a new checkpointer.

pub async fn save_partitions_concurrent( &self, id: &CheckpointId, snapshots: Vec<(String, u32, bool, Bytes)>, ) -> Result<Vec<(String, PartitionSnapshotEntry)>, CheckpointerError>

Save multiple operator partition snapshots concurrently.

Returns a map of (operator, partition) -> PartitionSnapshotEntry.

Errors

Returns CheckpointerError if any upload or join fails.

Trait Implementations

impl Checkpointer for ObjectStoreCheckpointer

fn save_manifest<'life0, 'life1, 'async_trait>( &'life0 self, manifest: &'life1 CheckpointManifestV2, ) -> Pin<Box<dyn Future<Output = Result<(), CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Write a manifest to the checkpoint store.

fn load_manifest<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 CheckpointId, ) -> Pin<Box<dyn Future<Output = Result<CheckpointManifestV2, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load a manifest by checkpoint ID.

fn save_snapshot<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, id: &'life1 CheckpointId, operator: &'life2 str, partition: u32, data: Bytes, ) -> Pin<Box<dyn Future<Output = Result<String, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write a state snapshot for a single operator partition.

fn save_delta<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, id: &'life1 CheckpointId, operator: &'life2 str, partition: u32, data: Bytes, ) -> Pin<Box<dyn Future<Output = Result<String, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write an incremental delta for a single operator partition.

fn load_artifact<'life0, 'life1, 'async_trait>( &'life0 self, path_str: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Bytes, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load a snapshot or delta by path.

fn update_latest<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 CheckpointId, ) -> Pin<Box<dyn Future<Output = Result<(), CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Update the _latest pointer to the given checkpoint.

fn read_latest<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<CheckpointId>, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Read the _latest pointer to find the most recent checkpoint.

fn list_checkpoints<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<CheckpointId>, CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all checkpoint IDs (sorted chronologically, oldest first).

fn delete_checkpoint<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 CheckpointId, ) -> Pin<Box<dyn Future<Output = Result<(), CheckpointerError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a checkpoint and all its artifacts.