Struct SegmentMeta 

pub struct SegmentMeta {
    pub segment_id: SegmentId,
    pub path: String,
    pub format: FileFormat,
    pub ts_min: DateTime<Utc>,
    pub ts_max: DateTime<Utc>,
    pub row_count: u64,
    pub file_size: Option<u64>,
    pub coverage_path: Option<String>,
}

Metadata about a single physical segment.

In v0.1, a “segment” corresponds to a single data file on disk.

Fields

segment_id: SegmentId

Logical identifier for this segment.

path: String

File path relative to the table root (for example, "data/nvda_1h_0001.parquet").

format: FileFormat

File format for this segment.

ts_min: DateTime<Utc>

Minimum timestamp contained in this segment (inclusive), in RFC3339 UTC.

ts_max: DateTime<Utc>

Maximum timestamp contained in this segment (inclusive), in RFC3339 UTC.

row_count: u64

Number of rows in this segment.

file_size: Option<u64>

Optional file size in bytes at the time metadata was captured.

coverage_path: Option<String>

Coverage sidecar pointer.

Implementations

impl SegmentMeta

pub fn with_coverage_path(self, path: impl Into<String>) -> Self

Set the coverage sidecar path for this segment metadata.

impl SegmentMeta

pub async fn for_parquet( location: &TableLocation, segment_id: SegmentId, path: &str, ts_min: DateTime<Utc>, ts_max: DateTime<Utc>, row_count: u64, ) -> SegmentResult<Self>

Construct a validated Parquet SegmentMeta for a file.

• location describes where the table lives (e.g. local root).
• path is the logical path stored in the log (e.g. “data/seg1.parquet” or an absolute path).

This is a v0.1 local-filesystem helper: it relies on storage::read_head_tail_4 which currently only supports TableLocation::Local.

pub async fn new_validated( location: &TableLocation, segment_id: SegmentId, path: &str, format: FileFormat, ts_min: DateTime<Utc>, ts_max: DateTime<Utc>, row_count: u64, ) -> SegmentResult<Self>

Format-dispatching constructor that can grow in future versions.

v0.1: only FileFormat::Parquet is supported and validated via for_parquet.

Trait Implementations

impl Clone for SegmentMeta

fn clone(&self) -> SegmentMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SegmentMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SegmentMeta

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SegmentMeta

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SegmentMeta

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SegmentMeta

impl StructuralPartialEq for SegmentMeta