Struct ForkInfo 

pub struct ForkInfo {
    pub id: ForkId,
    pub name: String,
    pub parent_fork_id: Option<ForkId>,
    pub parent_snapshot_id: String,
    pub created_at: DateTime<Utc>,
    pub ttl_expires_at: Option<DateTime<Utc>>,
    pub schema_version_at_creation: u32,
    pub datasets: BTreeMap<String, String>,
    pub status: ForkStatus,
}

Metadata for a single fork.

One ForkInfo per fork in catalog/fork_registry.json. The datasets map is filled in step 4 of the create 2PC and is authoritative for which Lance branches the fork owns.

Fields

id: ForkId

Stable identifier; persists across rename if rename ever lands.

name: String

Human-readable name (unique per database).

parent_fork_id: Option<ForkId>

Parent fork in a nested-fork chain. None ⇒ parent is primary. Phase 1 always sets None.

parent_snapshot_id: String

Snapshot id of primary at the moment the fork was created.

created_at: DateTime<Utc>

Wall-clock UTC at fork creation.

ttl_expires_at: Option<DateTime<Utc>>

Wall-clock TTL expiry. None ⇒ never expires. Phase 1 always None; the sweeper lands in Phase 4.

schema_version_at_creation: u32

Schema version (Schema::schema_version) at fork creation. Captured day-one even though only Phase 7’s schema-evolution spike consumes it; backfilling later is impossible.

datasets: BTreeMap<String, String>

Map of dataset_name → branch_name for every Lance dataset this fork owns. Branch names live under the dataset’s tree/ directory in Lance’s on-disk layout.

status: ForkStatus

Lifecycle state. See ForkStatus.

Implementations

impl ForkInfo

pub fn new_pending( id: ForkId, name: impl Into<String>, parent_snapshot_id: impl Into<String>, schema_version: u32, ) -> Self

Convenience: build a Pending info ready for create 2PC step 2.

Trait Implementations

impl Clone for ForkInfo

fn clone(&self) -> ForkInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForkInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ForkInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ForkInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.