org.apache.iceberg

Interface AppendFiles

All Superinterfaces:

PendingUpdate<Snapshot>, SnapshotUpdate<AppendFiles>

public interface AppendFiles
extends SnapshotUpdate<AppendFiles>

API for appending new files in a table.

This API accumulates file additions, produces a new Snapshot of the table, and commits that snapshot as the current.

When committing, these changes will be applied to the latest table snapshot. Commit conflicts will be resolved by applying the changes to the new latest snapshot and reattempting the commit.

Method Summary

Modifier and Type	Method and Description
AppendFiles	appendFile(DataFile file) Append a DataFile to the table.
AppendFiles	appendManifest(ManifestFile file) Append a ManifestFile to the table.

Methods inherited from interface org.apache.iceberg.SnapshotUpdate

deleteWith, set, stageOnly

Methods inherited from interface org.apache.iceberg.PendingUpdate

apply, commit, updateEvent

Method Detail

appendFile

AppendFiles appendFile(DataFile file)

Append a DataFile to the table.

Parameters:

file - a data file

Returns:

this for method chaining

appendManifest

AppendFiles appendManifest(ManifestFile file)

Append a ManifestFile to the table.

The manifest must contain only appended files. All files in the manifest will be appended to the table in the snapshot created by this update.

By default, the manifest will be rewritten to assign all entries this update's snapshot ID. In that case, it is always the responsibility of the caller to manage the lifecycle of the original manifest.

If manifest entries are allowed to inherit the snapshot ID assigned on commit, the manifest should never be deleted manually if the commit succeeds as it will become part of the table metadata and will be cleaned up on expiry. If the manifest gets merged with others while preparing a new snapshot, it will be deleted automatically if this operation is successful. If the commit fails, the manifest will never be deleted and it is up to the caller whether to delete or reuse it.

Parameters:

file - a manifest file

Returns:

this for method chaining