pub struct GroupCommitter { /* private fields */ }Expand description
Thread-safe group commit coordinator.
Multiple threads call submit() which blocks until the record is durable.
Internally, one thread becomes the commit leader and batches all pending
writes into a single WAL flush.
§Safety invariants
- A non-leader thread only returns
durable: trueif it confirms its write was drained from the pending queue and the leader’s fsync succeeded (checked vialast_commit_failed). - If the leader’s fsync fails, all non-leader threads whose writes were in the failed batch receive an error.
durable_lsnis updated only after a successful fsync.
Implementations§
Source§impl GroupCommitter
impl GroupCommitter
Sourcepub fn submit(
&self,
writer: &Mutex<WalWriter>,
write: PendingWrite,
) -> Result<CommitResult>
pub fn submit( &self, writer: &Mutex<WalWriter>, write: PendingWrite, ) -> Result<CommitResult>
Submit a write and block until it’s durable.
Returns the assigned LSN once the batch containing this write has been fsynced to disk. If fsync fails, the error is propagated to all threads whose writes were in the failed batch.
Sourcepub fn durable_lsn(&self) -> u64
pub fn durable_lsn(&self) -> u64
Current durable LSN (all records <= this are on disk).
Trait Implementations§
Auto Trait Implementations§
impl !Freeze for GroupCommitter
impl RefUnwindSafe for GroupCommitter
impl Send for GroupCommitter
impl Sync for GroupCommitter
impl Unpin for GroupCommitter
impl UnsafeUnpin for GroupCommitter
impl UnwindSafe for GroupCommitter
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more