Struct MetadataSegmentRef 

pub struct MetadataSegmentRef {

    pub owner_namespace_id: NamespaceId,
    pub segment_id: MetadataSegmentId,
    pub compaction_job_id: Option<MetadataCompactionId>,
    pub run_no: RunNo,
    pub run_seq: ChangeSeq,
    pub level: u32,
    pub family: MetadataRowFamily,
    pub segment_index: u32,
    pub row_count: u64,
    pub min_row_key: String,
    pub max_row_key: String,
    pub index_block: BlockHandle,
    pub filter_block: BlockHandle,
    pub filter_inline: Option<String>,
    pub object_checksum: String,
}

Reference to one immutable metadata segment in a namespace manifest.

See metadata segments.

Fields

owner_namespace_id: NamespaceId

Namespace that stores the segment. This may be a fork source.

segment_id: MetadataSegmentId

Immutable segment id used in the durable object key.

compaction_job_id: Option<MetadataCompactionId>

Compaction job id when the segment is stored under a compaction prefix. Flushed segments omit this field and use metadata/segments/. The owner, segment id, and optional job id determine the object key.

run_no: RunNo

Run this segment belongs to. Every segment one producer wrote together carries the same run number, and no two runs share one.

run_seq: ChangeSeq

Namespace sequence at which this run was produced.

level: u32

Compaction tier used to order overlapping runs during reads and reorganization.

family: MetadataRowFamily

Row schema and lookup ordering encoded in this segment.

segment_index: u32

Zero-based shard position among segments emitted for the same family and run.

row_count: u64

Number of row payloads in the segment, used for validation and planning.

min_row_key: String

Inclusive least durable row key; the segment is corrupt if decoded rows disagree.

max_row_key: String

Inclusive greatest durable row key; range planning skips disjoint segments.

index_block: BlockHandle

Location and verification data for the segment index block.

Segments have no footer, so readers begin with this handle.

filter_block: BlockHandle

Where the segment’s bloom filter block lives and how to verify it.

filter_inline: Option<String>

The filter block’s stored bytes inlined as hex, present when the filter is small (small delta runs). Point lookups consult it to skip the segment without any object fetch; filter_block still names and verifies the same bytes, so the inline copy must decode byte-for-byte identical (same length and CRC32C) or the manifest is corrupt.

object_checksum: String

SHA-256 of the complete stored segment, formatted as sha256:<64 lowercase hex>. Caches and offline verification use this value. Ranged reads verify each block with its CRC32C instead.

Trait Implementations

impl Clone for MetadataSegmentRef

fn clone(&self) -> MetadataSegmentRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataSegmentRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MetadataSegmentRef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MetadataSegmentRef

impl PartialEq for MetadataSegmentRef

fn eq(&self, other: &MetadataSegmentRef) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for MetadataSegmentRef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MetadataSegmentRef