Package io.delta.kernel

Interface TableManager

@Experimental
public interface TableManager

The entry point for loading and creating Delta tables.

TableManager provides static factory methods for creating builders that can resolve Delta tables to specific snapshots. This is the primary interface for table discovery and resolution in the Delta Kernel.

Method Summary

Static Methods

Modifier and Type	Method	Description
static CreateTableTransactionBuilder	buildCreateTableTransaction(String path, StructType schema, String engineInfo)	Creates a CreateTableTransactionBuilder to build a create table transaction.
static CommitRangeBuilder	loadCommitRange(String path, CommitRangeBuilder.CommitBoundary startBoundary)	Creates a builder for loading a CommitRange at a given path.
static SnapshotBuilder	loadSnapshot(String path)	Creates a builder for loading a snapshot at the given path.

Method Details

loadSnapshot

static SnapshotBuilder loadSnapshot(String path)

Creates a builder for loading a snapshot at the given path.

The returned builder can be configured to load the snapshot at a specific version or with additional metadata to optimize the loading process. If no version is specified, the builder will resolve to the latest version of the table.

Parameters:

path - the file system path to the Delta table

Returns:

a SnapshotBuilder that can be used to load a Snapshot at the given path

buildCreateTableTransaction

static CreateTableTransactionBuilder buildCreateTableTransaction(String path,
 StructType schema,
 String engineInfo)

Creates a CreateTableTransactionBuilder to build a create table transaction.

Parameters:

path - the file system path for the delta table being created

schema - the schema for the delta table being created

engineInfo - information about the engine that is making the update.

Returns:

create table builder instance to build the transaction

Since:

3.4.0

loadCommitRange

static CommitRangeBuilder loadCommitRange(String path,
 CommitRangeBuilder.CommitBoundary startBoundary)

Creates a builder for loading a CommitRange at a given path.

The returned builder can be configured with an end version or timestamp, and with additional metadata to optimize the loading process.

Parameters:

path - the file system path to the Delta table

startBoundary - the boundary specification for the start of the commit range, must not be null

Returns:

a CommitRangeBuilder that can be used to load a CommitRange at the given path