Interface IcebergTableMetadata.Builder

All Superinterfaces:
Buildable, CopyableBuilder<IcebergTableMetadata.Builder,IcebergTableMetadata>, SdkBuilder<IcebergTableMetadata.Builder,IcebergTableMetadata>, SdkPojo
Enclosing class:
IcebergTableMetadata
@Mutable @NotThreadSafe public static interface IcebergTableMetadata.Builder extends SdkPojo, CopyableBuilder<IcebergTableMetadata.Builder,IcebergTableMetadata>

  • Method Details

    • formatVersion

      IcebergTableMetadata.Builder formatVersion(String formatVersion)

      The Apache Iceberg table format version, such as 1 or 2. Determines the set of features and on-disk layout supported by the table.

      Parameters:
      formatVersion - The Apache Iceberg table format version, such as 1 or 2. Determines the set of features and on-disk layout supported by the table.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • tableUuid

      IcebergTableMetadata.Builder tableUuid(String tableUuid)

      The unique identifier (UUID) for the Iceberg table, assigned when the table is created and used to track the table across metadata updates.

      Parameters:
      tableUuid - The unique identifier (UUID) for the Iceberg table, assigned when the table is created and used to track the table across metadata updates.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • location

      IcebergTableMetadata.Builder location(String location)

      The base S3 location where the Iceberg table's data and metadata files are stored.

      Parameters:
      location - The base S3 location where the Iceberg table's data and metadata files are stored.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • properties

      IcebergTableMetadata.Builder properties(Map<String,String> properties)

      A map of key-value pairs that define table-level properties and configuration settings for the Iceberg table.

      Parameters:
      properties - A map of key-value pairs that define table-level properties and configuration settings for the Iceberg table.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • schemas

      IcebergTableMetadata.Builder schemas(Collection<IcebergSchema> schemas)

      The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution.

      Parameters:
      schemas - The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • schemas

      IcebergTableMetadata.Builder schemas(IcebergSchema... schemas)

      The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution.

      Parameters:
      schemas - The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • schemas

      IcebergTableMetadata.Builder schemas(Consumer<IcebergSchema.Builder>... schemas)

      The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution.

      This is a convenience method that creates an instance of the IcebergSchema.Builder avoiding the need to create one manually via IcebergSchema.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to schemas(List<IcebergSchema>).

      Parameters:
      schemas - a consumer that will call methods on IcebergSchema.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • currentSchemaId

      IcebergTableMetadata.Builder currentSchemaId(Integer currentSchemaId)

      The identifier of the schema that is currently active for the Iceberg table. Matches an entry in Schemas.

      Parameters:
      currentSchemaId - The identifier of the schema that is currently active for the Iceberg table. Matches an entry in Schemas.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • lastColumnId

      IcebergTableMetadata.Builder lastColumnId(Integer lastColumnId)

      The highest column identifier that has been assigned in the Iceberg table's schema, used to ensure unique IDs as new columns are added.

      Parameters:
      lastColumnId - The highest column identifier that has been assigned in the Iceberg table's schema, used to ensure unique IDs as new columns are added.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • partitionSpecs

      IcebergTableMetadata.Builder partitionSpecs(Collection<IcebergPartitionSpec> partitionSpecs)

      The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution.

      Parameters:
      partitionSpecs - The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • partitionSpecs

      IcebergTableMetadata.Builder partitionSpecs(IcebergPartitionSpec... partitionSpecs)

      The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution.

      Parameters:
      partitionSpecs - The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • partitionSpecs

      IcebergTableMetadata.Builder partitionSpecs(Consumer<IcebergPartitionSpec.Builder>... partitionSpecs)

      The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution.

      This is a convenience method that creates an instance of the IcebergPartitionSpec.Builder avoiding the need to create one manually via IcebergPartitionSpec.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to partitionSpecs(List<IcebergPartitionSpec>).

      Parameters:
      partitionSpecs - a consumer that will call methods on IcebergPartitionSpec.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • defaultSpecId

      IcebergTableMetadata.Builder defaultSpecId(Integer defaultSpecId)

      The identifier of the partition specification that is currently used by default when writing new data to the Iceberg table.

      Parameters:
      defaultSpecId - The identifier of the partition specification that is currently used by default when writing new data to the Iceberg table.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • lastPartitionId

      IcebergTableMetadata.Builder lastPartitionId(Integer lastPartitionId)

      The highest partition field identifier that has been assigned across the table's partition specifications.

      Parameters:
      lastPartitionId - The highest partition field identifier that has been assigned across the table's partition specifications.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • sortOrders

      IcebergTableMetadata.Builder sortOrders(Collection<IcebergSortOrder> sortOrders)

      The list of sort order specifications that have been associated with the Iceberg table over its history.

      Parameters:
      sortOrders - The list of sort order specifications that have been associated with the Iceberg table over its history.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • sortOrders

      IcebergTableMetadata.Builder sortOrders(IcebergSortOrder... sortOrders)

      The list of sort order specifications that have been associated with the Iceberg table over its history.

      Parameters:
      sortOrders - The list of sort order specifications that have been associated with the Iceberg table over its history.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • sortOrders

      IcebergTableMetadata.Builder sortOrders(Consumer<IcebergSortOrder.Builder>... sortOrders)

      The list of sort order specifications that have been associated with the Iceberg table over its history.

      This is a convenience method that creates an instance of the IcebergSortOrder.Builder avoiding the need to create one manually via IcebergSortOrder.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to sortOrders(List<IcebergSortOrder>).

      Parameters:
      sortOrders - a consumer that will call methods on IcebergSortOrder.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • defaultSortOrderId

      IcebergTableMetadata.Builder defaultSortOrderId(Integer defaultSortOrderId)

      The identifier of the sort order that is currently used by default when writing new data to the Iceberg table.

      Parameters:
      defaultSortOrderId - The identifier of the sort order that is currently used by default when writing new data to the Iceberg table.
      Returns:
      Returns a reference to this object so that method calls can be chained together.