Package org.projectnessie.model

Class IcebergTable

java.lang.Object

org.projectnessie.model.Content

org.projectnessie.model.IcebergContent

org.projectnessie.model.IcebergTable

@Immutable
public abstract class IcebergTable
extends IcebergContent

Represents the state of an Iceberg table in Nessie. An Iceberg table is globally identified via its unique ID.

The Iceberg-table-state consists of the location to the table-metadata and the state of relevant IDs using a serialized version of those.

When adding a new table (aka content-object identified by a content-id), use a Operation.Put without an expected-value. In all other cases (updating an existing table). always pass the last known version of IcebergTable as the expected-value within the put-operation.

Nested Class Summary

Nested classes/interfaces inherited from class org.projectnessie.model.Content

Content.Type

Field Summary

Fields inherited from class org.projectnessie.model.IcebergContent

CURRENT_SCHEMA_ID, CURRENT_SNAPSHOT_ID, CURRENT_VERSION_ID, DEFAULT_SORT_ORDER_ID, DEFAULT_SPEC_ID, FORMAT_VERSION, ICEBERG_METADATA_VARIANT, ORDER_ID, PARTITION_SPECS, SCHEMA, SCHEMA_ID, SCHEMAS, SNAPSHOT_ID, SNAPSHOTS, SORT_ORDERS, SPEC_ID, SQL, VERSION_ID, VERSIONS, VIEW_DEFINITION

Constructor Summary

Constructors

Constructor	Description
IcebergTable()

Method Summary

Modifier and Type	Method	Description
static org.projectnessie.model.ImmutableIcebergTable.Builder	builder()
abstract GenericMetadata	getMetadata()
abstract @NotNull @NotBlank java.lang.String	getMetadataLocation()	Location where Iceberg stored its TableMetadata file.
abstract int	getSchemaId()	Corresponds to Iceberg's currentSchemaId.
abstract long	getSnapshotId()	Corresponds to Iceberg's currentSnapshotId.
abstract int	getSortOrderId()	Corresponds to Iceberg's defaultSortOrderId.
abstract int	getSpecId()	Corresponds to Iceberg's defaultSpecId.
Content.Type	getType()	Returns the Content.Type enum constant for this content object.
static IcebergTable	of(com.fasterxml.jackson.databind.JsonNode metadata, java.lang.String metadataLocation, java.lang.String contentId)
static IcebergTable	of(java.lang.String metadataLocation, long snapshotId, int schemaId, int specId, int sortOrderId)
static IcebergTable	of(java.lang.String metadataLocation, long snapshotId, int schemaId, int specId, int sortOrderId, java.lang.String contentId)

Methods inherited from class org.projectnessie.model.Content

getId, unwrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IcebergTable

public IcebergTable()

Method Detail

getMetadataLocation

@NotNull
@NotBlank
public abstract @NotNull @NotBlank java.lang.String getMetadataLocation()

Location where Iceberg stored its TableMetadata file. The location depends on the (implementation of) Iceberg's FileIO configured for the particular Iceberg table.

getSnapshotId

public abstract long getSnapshotId()

Corresponds to Iceberg's currentSnapshotId.

getSchemaId

public abstract int getSchemaId()

Corresponds to Iceberg's currentSchemaId.

getSpecId

public abstract int getSpecId()

Corresponds to Iceberg's defaultSpecId.

getSortOrderId

public abstract int getSortOrderId()

Corresponds to Iceberg's defaultSortOrderId.

getType

public Content.Type getType()

Description copied from class: Content

Returns the Content.Type enum constant for this content object.

The name of the returned enum value should match the JSON type name used for serializing the content object.

Specified by:

getType in class Content

getMetadata

@Nullable
public abstract GenericMetadata getMetadata()

builder

public static org.projectnessie.model.ImmutableIcebergTable.Builder builder()

of

public static IcebergTable of(java.lang.String metadataLocation,
                              long snapshotId,
                              int schemaId,
                              int specId,
                              int sortOrderId)

of

public static IcebergTable of(java.lang.String metadataLocation,
                              long snapshotId,
                              int schemaId,
                              int specId,
                              int sortOrderId,
                              java.lang.String contentId)

of

public static IcebergTable of(com.fasterxml.jackson.databind.JsonNode metadata,
                              java.lang.String metadataLocation,
                              java.lang.String contentId)