Package io.delta.kernel.internal.files

Class ParsedCheckpointData

Object

io.delta.kernel.internal.files.ParsedLogData

io.delta.kernel.internal.files.ParsedCheckpointData

All Implemented Interfaces:

Comparable<ParsedCheckpointData>

Direct Known Subclasses:

ParsedClassicCheckpointData, ParsedMultiPartCheckpointData, ParsedV2CheckpointData

public abstract class ParsedCheckpointData
extends ParsedLogData
implements Comparable<ParsedCheckpointData>

Abstract checkpoint file that contains a complete snapshot of table state at a specific version.

Method Summary

Modifier and Type	Method	Description
int	compareTo(ParsedCheckpointData that)	Compares checkpoints for ordering preference.
static ParsedCheckpointData	forFileStatus(FileStatus fileStatus)
Class<? extends ParsedLogData>	getGroupByCategoryClass()	Returns the category class used for grouping collections of LISTed ParsedLogData instances.

Methods inherited from class io.delta.kernel.internal.files.ParsedLogData

equals, getFileStatus, getInlineData, getVersion, hashCode, isFile, isInline, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

forFileStatus

public static ParsedCheckpointData forFileStatus(FileStatus fileStatus)

getGroupByCategoryClass

public Class<? extends ParsedLogData> getGroupByCategoryClass()

Description copied from class: ParsedLogData

Returns the category class used for grouping collections of LISTed ParsedLogData instances.

Specified by:

getGroupByCategoryClass in class ParsedLogData

compareTo

public int compareTo(ParsedCheckpointData that)

Compares checkpoints for ordering preference. Returns positive if *this* checkpoint is preferred over *that* checkpoint, negative if *that* is preferred, or zero if equal.

Comparison hierarchy:

1. Version (most important): Higher version numbers are always preferred over lower ones, as newer checkpoints contain more recent data
2. Checkpoint type: When versions are equal, prefer by type priority based on safety and performance characteristics (V2 > MultiPart > Classic)
3. Type-specific logic: When version and type are equal, use type-specific comparison (e.g., MultiPart prefers more parts for better parallelization)

Specified by:

compareTo in interface Comparable<ParsedCheckpointData>