ContentFile

Type Parameters:

F - the concrete Java class of a ContentFile instance.

All Known Subinterfaces:

DataFile, DeleteFile

All Known Implementing Classes:

SparkDataFile
```
public interface ContentFile<F>
```
Superinterface of DataFile and DeleteFile that exposes common methods.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`java.util.Map<java.lang.Integer,java.lang.Long>`	`columnSizes()` Returns if collected, map from column ID to the size of the column in bytes, null otherwise.
`FileContent`	`content()` Returns type of content stored in the file; one of DATA, POSITION_DELETES, or EQUALITY_DELETES.
`F`	`copy()` Copies this file.
`default F`	`copy(boolean withStats)` Copies this file (potentially without file stats).
`F`	`copyWithoutStats()` Copies this file without file stats.
`default java.lang.Long`	`dataSequenceNumber()` Returns the data sequence number of the file.
`java.util.List<java.lang.Integer>`	`equalityFieldIds()` Returns the set of field IDs used for equality comparison, in equality delete files.
`default java.lang.Long`	`fileSequenceNumber()` Returns the file sequence number.
`long`	`fileSizeInBytes()` Returns the file size in bytes.
`FileFormat`	`format()` Returns format of the file.
`java.nio.ByteBuffer`	`keyMetadata()` Returns metadata about how this file is encrypted, or null if the file is stored in plain text.
`java.util.Map<java.lang.Integer,java.nio.ByteBuffer>`	`lowerBounds()` Returns if collected, map from column ID to value lower bounds, null otherwise.
`java.util.Map<java.lang.Integer,java.lang.Long>`	`nanValueCounts()` Returns if collected, map from column ID to its NaN value count, null otherwise.
`java.util.Map<java.lang.Integer,java.lang.Long>`	`nullValueCounts()` Returns if collected, map from column ID to its null value count, null otherwise.
`StructLike`	`partition()` Returns partition for this file as a `StructLike`.
`java.lang.CharSequence`	`path()` Returns fully qualified path to the file, suitable for constructing a Hadoop Path.
`java.lang.Long`	`pos()` Returns the ordinal position of the file in a manifest, or null if it was not read from a manifest.
`long`	`recordCount()` Returns the number of top-level records in the file.
`default java.lang.Integer`	`sortOrderId()` Returns the sort order id of this file, which describes how the file is ordered.
`int`	`specId()` Returns id of the partition spec used for partition metadata.
`java.util.List<java.lang.Long>`	`splitOffsets()` Returns list of recommended split locations, if applicable, null otherwise.
`java.util.Map<java.lang.Integer,java.nio.ByteBuffer>`	`upperBounds()` Returns if collected, map from column ID to value upper bounds, null otherwise.
`java.util.Map<java.lang.Integer,java.lang.Long>`	`valueCounts()` Returns if collected, map from column ID to the count of its non-null values, null otherwise.

- Method Detail
  - pos
```
java.lang.Long pos()
```
    Returns the ordinal position of the file in a manifest, or null if it was not read from a manifest.
  - specId
```
int specId()
```
    Returns id of the partition spec used for partition metadata.
  - content
```
FileContent content()
```
    Returns type of content stored in the file; one of DATA, POSITION_DELETES, or EQUALITY_DELETES.
  - path
```
java.lang.CharSequence path()
```
    Returns fully qualified path to the file, suitable for constructing a Hadoop Path.
  - format
```
FileFormat format()
```
    Returns format of the file.
  - partition
```
StructLike partition()
```
    Returns partition for this file as a StructLike.
  - recordCount
```
long recordCount()
```
    Returns the number of top-level records in the file.
  - fileSizeInBytes
```
long fileSizeInBytes()
```
    Returns the file size in bytes.
  - columnSizes
```
java.util.Map<java.lang.Integer,java.lang.Long> columnSizes()
```
    Returns if collected, map from column ID to the size of the column in bytes, null otherwise.
  - valueCounts
```
java.util.Map<java.lang.Integer,java.lang.Long> valueCounts()
```
    Returns if collected, map from column ID to the count of its non-null values, null otherwise.
  - nullValueCounts
```
java.util.Map<java.lang.Integer,java.lang.Long> nullValueCounts()
```
    Returns if collected, map from column ID to its null value count, null otherwise.
  - nanValueCounts
```
java.util.Map<java.lang.Integer,java.lang.Long> nanValueCounts()
```
    Returns if collected, map from column ID to its NaN value count, null otherwise.
  - lowerBounds
```
java.util.Map<java.lang.Integer,java.nio.ByteBuffer> lowerBounds()
```
    Returns if collected, map from column ID to value lower bounds, null otherwise.
  - upperBounds
```
java.util.Map<java.lang.Integer,java.nio.ByteBuffer> upperBounds()
```
    Returns if collected, map from column ID to value upper bounds, null otherwise.
  - keyMetadata
```
java.nio.ByteBuffer keyMetadata()
```
    Returns metadata about how this file is encrypted, or null if the file is stored in plain text.
  - splitOffsets
```
java.util.List<java.lang.Long> splitOffsets()
```
    Returns list of recommended split locations, if applicable, null otherwise.
    When available, this information is used for planning scan tasks whose boundaries are determined by these offsets. The returned list must be sorted in ascending order.
  - equalityFieldIds
```
java.util.List<java.lang.Integer> equalityFieldIds()
```
    Returns the set of field IDs used for equality comparison, in equality delete files.
    An equality delete file may contain additional data fields that are not used by equality comparison. The subset of columns in a delete file to be used in equality comparison are tracked by ID. Extra columns can be used to reconstruct changes and metrics from extra columns are used during job planning.
    
    Returns:
    
    IDs of the fields used in equality comparison with the records in this delete file
  - sortOrderId
```
default java.lang.Integer sortOrderId()
```
    Returns the sort order id of this file, which describes how the file is ordered. This information will be useful for merging data and equality delete files more efficiently when they share the same sort order id.
  - dataSequenceNumber
```
default java.lang.Long dataSequenceNumber()
```
    Returns the data sequence number of the file.
    This method represents the sequence number to which the file should apply. Note the data sequence number may differ from the sequence number of the snapshot in which the underlying file was added (a.k.a the file sequence number). New snapshots can add files that belong to older sequence numbers (e.g. compaction). The data sequence number also does not change when the file is marked as deleted.
    This method can return null if the data sequence number is unknown. This may happen while reading a v2 manifest that did not persist the data sequence number for manifest entries with status DELETED (older Iceberg versions).
  - fileSequenceNumber
```
default java.lang.Long fileSequenceNumber()
```
    Returns the file sequence number.
    The file sequence number represents the sequence number of the snapshot in which the underlying file was added. The file sequence number is always assigned at commit and cannot be provided explicitly, unlike the data sequence number. The file sequence number does not change upon assigning. In case of rewrite (like compaction), file sequence number can be higher than the data sequence number.
    This method can return null if the file sequence number is unknown. This may happen while reading a v2 manifest that did not persist the file sequence number for manifest entries with status EXISTING or DELETED (older Iceberg versions).
  - copy
```
F copy()
```
    Copies this file. Manifest readers can reuse file instances; use this method to copy data when collecting files from tasks.
    
    Returns:
    
    a copy of this data file
  - copyWithoutStats
```
F copyWithoutStats()
```
    Copies this file without file stats. Manifest readers can reuse file instances; use this method to copy data without stats when collecting files.
    
    Returns:
    
    a copy of this data file, without lower bounds, upper bounds, value counts, null value counts, or nan value counts
  - copy
```
default F copy(boolean withStats)
```
    Copies this file (potentially without file stats). Manifest readers can reuse file instances; use this method to copy data when collecting files from tasks.
    
    Parameters:
    
    withStats - Will copy this file without file stats if set to false.
    
    Returns:
    
    a copy of this data file. If withStats is set to false the file will not contain lower bounds, upper bounds, value counts, null value counts, or nan value counts

Interface ContentFile<F>

Method Summary

Method Detail

pos

specId

content

path

format

partition

recordCount

fileSizeInBytes

columnSizes

valueCounts

nullValueCounts

nanValueCounts

lowerBounds

upperBounds

keyMetadata

splitOffsets

equalityFieldIds

sortOrderId

dataSequenceNumber

fileSequenceNumber

copy

copyWithoutStats

copy