Struct DataFileEntry 

pub struct DataFileEntry {

    pub path: String,
    pub record_count: u64,
    pub file_size_bytes: u64,
    pub centroid_b64: Option<String>,
    pub radius: Option<f32>,
    pub hnsw_offset: Option<u64>,
    pub hnsw_len: Option<u64>,
    pub vector_column: Option<String>,
    pub vector_dim: Option<u32>,
    pub extra_vector_indexes: Vec<ExtraVectorIndex>,
    pub index_status: IndexStatus,
    pub batch_id: Option<String>,
    pub embedding_model: Option<String>,
    pub partition_value: Option<String>,
    pub deletion_vector: Option<DeletionVector>,
    pub first_row_id: Option<i64>,
}

Metadata about a single data file in a table snapshot.

Fields

path: String

Relative path within the warehouse (e.g., “data/part-00001.parquet”)

record_count: u64

file_size_bytes: u64

centroid_b64: Option<String>

base64-encoded centroid F32 values (primary vector column)

radius: Option<f32>

hnsw_offset: Option<u64>

hnsw_len: Option<u64>

vector_column: Option<String>

vector_dim: Option<u32>

extra_vector_indexes: Vec<ExtraVectorIndex>

Additional vector columns beyond the primary (empty for single-column tables).

index_status: IndexStatus

Index build status. Defaults to Ready for backward compatibility with old manifests.

batch_id: Option<String>

Caller-supplied idempotency key. When set, write_batch_idempotent skips the write if a file with the same batch_id is already committed in the snapshot.

embedding_model: Option<String>

Embedding model identifier stored per-file so mixed-model tables (during migration) can be identified without reading the main metadata.json.

partition_value: Option<String>

Partition value for this file (e.g. the agent_id UUID). Written per-file when VectorStoragePolicy::partition_by is set. Enables manifest-level pruning: search skips files whose partition_value doesn’t match the requested partition filter, avoiding all HNSW I/O.

deletion_vector: Option<DeletionVector>

Iceberg V3 Deletion Vector: Roaring Bitmap of deleted row positions. None for V2 tables or V3 tables with no deletes for this file. When present, scanner masks these row IDs from HNSW results.

first_row_id: Option<i64>

Iceberg V3 Row Lineage: globally unique first row ID assigned to this file. Computed at commit time from the table’s cumulative next-row-id counter. None for V2 tables (row lineage requires format-version=3).

Trait Implementations

impl Clone for DataFileEntry

fn clone(&self) -> DataFileEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataFileEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DataFileEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DataFileEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.