AWS cli documentation change
Summary
Updated CLI version references and added detailed documentation for Iceberg table configurations including field IDs, partition specs, write order, and JSON syntax examples
Security assessment
Changes focus on adding schema evolution tracking, partitioning, and sorting capabilities for Iceberg tables without mentioning security implications. No security vulnerabilities or security-specific features are referenced.
Diff
diff --git a/cli/latest/reference/s3tables/create-table.md b/cli/latest/reference/s3tables/create-table.md index 1c6ba0882..9036c8ca1 100644 --- a//cli/latest/reference/s3tables/create-table.md +++ b//cli/latest/reference/s3tables/create-table.md @@ -15 +15 @@ - * [AWS CLI 2.33.18 Command Reference](../../index.html) » + * [AWS CLI 2.33.21 Command Reference](../../index.html) » @@ -180,0 +181,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3tabl +>>>>> id -> (integer) +>>>>> +>>>>>> An optional unique identifier for the schema field. Field IDs are used by Apache Iceberg to track schema evolution and maintain compatibility across schema changes. If not specified, S3 Tables automatically assigns field IDs. +>>>>> @@ -191,0 +196,78 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3tabl +>> +>> partitionSpec -> (structure) +>> +>>> The partition specification for the Iceberg table. Partitioning organizes data into separate files based on the values of one or more fields, which can improve query performance by reducing the amount of data scanned. Each partition field applies a transform (such as identity, year, month, or bucket) to a single field. +>>> +>>> fields -> (list) [required] +>>> +>>>> The list of partition fields that define how the table data is partitioned. Each field specifies a source field and a transform to apply. This field is required if `partitionSpec` is provided. +>>>> +>>>> (structure) +>>>> +>>>>> Defines a single partition field in an Iceberg partition specification. +>>>>> +>>>>> sourceId -> (integer) [required] +>>>>> +>>>>>> The ID of the source schema field to partition by. This must reference a valid field ID from the table schema. +>>>>> +>>>>> transform -> (string) [required] +>>>>> +>>>>>> The partition transform to apply to the source field. Supported transforms include `identity` , `year` , `month` , `day` , `hour` , `bucket` , and `truncate` . For more information, see the [Apache Iceberg partition transforms documentation](https://iceberg.apache.org/spec/#partition-transforms) . +>>>>> +>>>>> name -> (string) [required] +>>>>> +>>>>>> The name for this partition field. This name is used in the partitioned file paths. +>>>>> +>>>>> fieldId -> (integer) +>>>>> +>>>>>> An optional unique identifier for this partition field. If not specified, S3 Tables automatically assigns a field ID. +>>> +>>> specId -> (integer) +>>> +>>>> The unique identifier for this partition specification. If not specified, defaults to `0` . +>> +>> writeOrder -> (structure) +>> +>>> The sort order for the Iceberg table. Sort order defines how data is sorted within data files, which can improve query performance by enabling more efficient data skipping and filtering. +>>> +>>> orderId -> (integer) [required] +>>> +>>>> The unique identifier for this sort order. If not specified, defaults to `1` . The order ID is used by Apache Iceberg to track sort order evolution. +>>> +>>> fields -> (list) [required] +>>> +>>>> The list of sort fields that define how data is sorted within files. Each field specifies a source field, sort direction, and null ordering. This field is required if `writeOrder` is provided. +>>>> +>>>> (structure) +>>>> +>>>>> Defines a single sort field in an Iceberg sort order specification. +>>>>> +>>>>> sourceId -> (integer) [required] +>>>>> +>>>>>> The ID of the source schema field to sort by. This must reference a valid field ID from the table schema. +>>>>> +>>>>> transform -> (string) [required] +>>>>> +>>>>>> The transform to apply to the source field before sorting. Use `identity` to sort by the field value directly, or specify other transforms as needed. +>>>>> +>>>>> direction -> (string) [required] +>>>>> +>>>>>> The sort direction. Valid values are `asc` for ascending order or `desc` for descending order. +>>>>>> +>>>>>> Possible values: +>>>>>> +>>>>>> * `asc` +>>>>>> * `desc` +>>>>>> + +>>>>> +>>>>> nullOrder -> (string) [required] +>>>>> +>>>>>> Specifies how null values are ordered. Valid values are `nulls-first` to place nulls before non-null values, or `nulls-last` to place nulls after non-null values. +>>>>>> +>>>>>> Possible values: +>>>>>> +>>>>>> * `nulls-first` +>>>>>> * `nulls-last` +>>>>>> + @@ -195 +277 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3tabl ->>> Contains configuration properties for an Iceberg table. +>>> A map of custom configuration properties for the Iceberg table. @@ -208,0 +291 @@ JSON Syntax: + "id": integer, @@ -215,0 +299,24 @@ JSON Syntax: + "partitionSpec": { + "fields": [ + { + "sourceId": integer, + "transform": "string", + "name": "string", + "fieldId": integer + } + ... + ], + "specId": integer + }, + "writeOrder": { + "orderId": integer, + "fields": [ + { + "sourceId": integer, + "transform": "string", + "direction": "asc"|"desc", + "nullOrder": "nulls-first"|"nulls-last" + } + ... + ] + }, @@ -468 +575 @@ versionToken -> (string) - * [AWS CLI 2.33.18 Command Reference](../../index.html) » + * [AWS CLI 2.33.21 Command Reference](../../index.html) »