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 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