pub struct ManifestSequencer { /* private fields */ }Implementations§
Source§impl ManifestSequencer
impl ManifestSequencer
Sourcepub async fn open(
blob: Arc<dyn BlobStore>,
manifest_prefix: impl Into<String>,
) -> Result<Self, ObjectLogError>
pub async fn open( blob: Arc<dyn BlobStore>, manifest_prefix: impl Into<String>, ) -> Result<Self, ObjectLogError>
Open (or recover) a persisted sequencer. Manifest objects live under
manifest_prefix (keep it disjoint from the engine’s data-object prefix).
Existing manifests are replayed to rebuild the index.
Sourcepub fn live_object_ids(&self) -> HashSet<String>
pub fn live_object_ids(&self) -> HashSet<String>
Object ids referenced by any live index entry (for orphan reaping). Does not include manifest object keys themselves.
Sourcepub fn snapshot(&self) -> IndexSnapshot
pub fn snapshot(&self) -> IndexSnapshot
Point-in-time view of the rebuilt index (diagnostics / CLI).
Trait Implementations§
Source§impl BoundedSequencer for ManifestSequencer
impl BoundedSequencer for ManifestSequencer
Source§fn lookup_page(
&self,
partition: &PartitionKey,
offset: i64,
max_entries: usize,
max_bytes: usize,
) -> Result<Vec<IndexEntry>, ObjectLogError>
fn lookup_page( &self, partition: &PartitionKey, offset: i64, max_entries: usize, max_bytes: usize, ) -> Result<Vec<IndexEntry>, ObjectLogError>
Caller reserves
max_metadata_bytes before calling. Includes vector entry
headers and cloned full object identifiers. Check retained log_start under
the same lock as page copying. No unbounded lookup fallback.Source§impl Drop for ManifestSequencer
impl Drop for ManifestSequencer
Source§impl Sequencer for ManifestSequencer
impl Sequencer for ManifestSequencer
Source§fn rejection_error(
&self,
partition: &PartitionKey,
epoch: u64,
reason: String,
) -> ObjectLogError
fn rejection_error( &self, partition: &PartitionKey, epoch: u64, reason: String, ) -> ObjectLogError
A batch rejected because this partition’s index was fenced past its epoch
can never commit: report ObjectLogError::Fenced. Other rejections stay
ObjectLogError::Sequencer. The index read during the rejected commit
is the one consulted.
Source§type Meta = ()
type Meta = ()
Sequencer-private per-batch metadata, forwarded uninterpreted by the
engine. object-log’s default sequencers use
(); a Kafka coordinator uses
its producer-identity fields.Source§fn supports_multi_object_commit(&self) -> bool
fn supports_multi_object_commit(&self) -> bool
Opt in to atomic commits containing already-durable batches from several
data objects, in creation order. Default preserves one-object calls for
custom sequencers that rely on that boundary.
Source§fn supports_conditional_commit(&self) -> bool
fn supports_conditional_commit(&self) -> bool
Whether this sequencer implements native durable head conditions.
Source§fn commit_conditionally(
&self,
batches: &[CommitBatch<'_, ()>],
expected_heads: &[Option<i64>],
) -> Result<Vec<ConditionalCommitOutcome>, ObjectLogError>
fn commit_conditionally( &self, batches: &[CommitBatch<'_, ()>], expected_heads: &[Option<i64>], ) -> Result<Vec<ConditionalCommitOutcome>, ObjectLogError>
Opt-in head compare-and-append. Conditions are next log offsets, not
record insertion counters or sparse hints. Partition publication remains
independent; this is not a cross-partition transaction. The default
rejects any condition before calling the legacy commit implementation.
Source§fn commit(
&self,
batches: &[CommitBatch<'_, ()>],
) -> Result<Vec<CommitOutcome>, ObjectLogError>
fn commit( &self, batches: &[CommitBatch<'_, ()>], ) -> Result<Vec<CommitOutcome>, ObjectLogError>
Assign offsets to durably uploaded batches and persist the index.
By default these belong to one object; an opted-in implementation may
receive several objects in one ordered call.
Returns one
CommitOutcome per input batch, in order. Read moreSource§fn fence_epoch(
&self,
partition: &PartitionKey,
expected: u64,
new_epoch: u64,
) -> Result<(), ObjectLogError>
fn fence_epoch( &self, partition: &PartitionKey, expected: u64, new_epoch: u64, ) -> Result<(), ObjectLogError>
Source§fn partition_epoch(&self, partition: &PartitionKey) -> Option<u64>
fn partition_epoch(&self, partition: &PartitionKey) -> Option<u64>
👎Deprecated since 0.3.6:
the engine no longer reads fence epochs; implement rejection_error instead
The fence epoch this handle last read for
partition, if it tracks one. Read moreAcquire a fresh durable writer epoch and the matching bounds from this
call’s successful CAS. This grants no ongoing writer exclusivity.
An error may follow a durable epoch advance; never infer no effect.
Unsupported implementations fail without legacy fence fallback.
Read validated durable state directly; unsupported implementations fail
without invoking legacy refresh or cached getters.
Source§fn refresh_partition(
&self,
partition: &PartitionKey,
) -> Result<(), ObjectLogError>
fn refresh_partition( &self, partition: &PartitionKey, ) -> Result<(), ObjectLogError>
Reload
partition’s index from durable storage, so this handle sees
commits made by other writers since it opened. Read moreSource§fn lookup(
&self,
partition: &PartitionKey,
fetch_offset: i64,
) -> Result<Vec<IndexEntry>, ObjectLogError>
fn lookup( &self, partition: &PartitionKey, fetch_offset: i64, ) -> Result<Vec<IndexEntry>, ObjectLogError>
Resolve
fetch_offset to the ordered index entries covering it onward.Source§fn high_watermark(
&self,
partition: &PartitionKey,
) -> Result<i64, ObjectLogError>
fn high_watermark( &self, partition: &PartitionKey, ) -> Result<i64, ObjectLogError>
The next offset to be assigned (index-only; no object reads).
Source§fn log_start_offset(
&self,
partition: &PartitionKey,
) -> Result<i64, ObjectLogError>
fn log_start_offset( &self, partition: &PartitionKey, ) -> Result<i64, ObjectLogError>
The first readable offset (advances on
truncate_before).Source§fn truncate_before(
&self,
partition: &PartitionKey,
offset: i64,
) -> Result<Vec<String>, ObjectLogError>
fn truncate_before( &self, partition: &PartitionKey, offset: i64, ) -> Result<Vec<String>, ObjectLogError>
Retention MECHANISM (not policy): drop index entries below
offset and
return object ids that now have no live references from any
partition (objects are multiplexed and shared), for the engine to delete.Auto Trait Implementations§
impl !Freeze for ManifestSequencer
impl !RefUnwindSafe for ManifestSequencer
impl !UnwindSafe for ManifestSequencer
impl Forget for ManifestSequencer
impl Send for ManifestSequencer
impl Sync for ManifestSequencer
impl Unpin for ManifestSequencer
impl UnsafeUnpin for ManifestSequencer
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