IcebergTableUpdate
Defines a complete set of updates to be applied to an Iceberg table, including schema changes, partitioning modifications, sort order adjustments, location updates, and property changes.
Contents
- Location
-
The updated S3 location where the Iceberg table data will be stored.
Type: String
Length Constraints: Maximum length of 2056.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: Yes
- Schema
-
The updated schema definition for the Iceberg table, specifying any changes to field structure, data types, or schema metadata.
Type: IcebergSchema object
Required: Yes
- Action
-
The type of update action to be performed on the Iceberg table. Defines the specific operation such as adding schema, setting current schema, adding partition spec, or managing encryption keys.
Type: String
Valid Values:
add-schema | set-current-schema | add-spec | set-default-spec | add-sort-order | set-default-sort-order | set-location | set-properties | remove-properties | add-encryption-key | remove-encryption-keyRequired: No
- EncryptionKey
-
Encryption key information associated with an Iceberg table update operation. Used when adding or removing encryption keys from the table metadata during table evolution.
Type: IcebergEncryptedKey object
Required: No
- KeyId
-
Identifier of the encryption key involved in an Iceberg table update operation. References the specific key being added to or removed from the table's encryption configuration.
Type: String
Length Constraints: Maximum length of 2056.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: No
- PartitionSpec
-
The updated partitioning specification that defines how the table data should be reorganized and partitioned.
Type: IcebergPartitionSpec object
Required: No
- Properties
-
Updated key-value pairs of table properties and configuration settings for the Iceberg table.
Type: String to string map
Required: No
- SortOrder
-
The updated sort order specification that defines how data should be ordered within partitions for optimal query performance.
Type: IcebergSortOrder object
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: