feat(s3tables-alpha): add support for partition spec, sort order, and table properties (#36811)

### Reason for this change

This PR adds support for new S3 Tables Iceberg features to the L2 construct library, enabling users to configure partition specifications, sort orders, table properties, and schema field IDs when creating tables.

These features are essential for optimizing query performance and data organization in Iceberg tables.

### Description of changes

**Enhanced Table construct with new Iceberg metadata properties**:
- Added `id` field to `SchemaFieldProperty` for schema field identification
- Added `IcebergPartitionSpec` and `IcebergPartitionField` interfaces for partition configuration
- Added `IcebergSortOrder` and `IcebergSortField` interfaces for sort order configuration  
- Added `tableProperties` support for custom Iceberg table properties
- Updated `IcebergMetadataProperty` to include optional `icebergPartitionSpec`, `icebergSortOrder`, and `tableProperties`

**Documentation**:
- Added comprehensive examples for `IcebergPartitionField`, `IcebergPartitionSpec`, and `IcebergSortOrder`
- Updated README with "Advanced Iceberg Table Configuration" section showing complete usage examples

### Description of how you validated changes

- **Unit tests**: Added comprehensive test coverage for new features (192 tests passing)
- **Integration test**: Created `integ.table-with-partition-sort.ts` to validate partition spec, sort order, and table properties
- **Manual testing**: Successfully deployed and validated in Gamma environment where the CloudFormation resource type with new properties is available. Verified that partition spec, sort order, and table properties are correctly applied to the Iceberg table metadata.

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: olenarostotskyy

packages/@aws-cdk/aws-s3tables-alpha/README.md

@@ -94,6 +94,82 @@ const sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {
 
 Learn more about table buckets maintenance operations and default behavior from the [S3 Tables User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html)
 
+### Advanced Iceberg Table Configuration
+
+You can configure partition specifications, sort orders, and table properties for optimized query performance.
+
+The simplest way to add partitioning to your table:
+
+```ts
+// Build a table with partition spec (minimal configuration)
+const partitionedTable = new Table(scope, 'PartitionedTable', {
+    tableName: 'partitioned_table',
+    namespace: namespace,
+    openTableFormat: OpenTableFormat.ICEBERG,
+    icebergMetadata: {
+        icebergSchema: {
+            schemaFieldList: [
+                { name: 'event_date', type: 'date', required: true },
+                { name: 'event_name', type: 'string' },
+            ],
+        },
+        icebergPartitionSpec: {
+            fields: [
+                {
+                    sourceId: 1,
+                    transform: IcebergTransform.IDENTITY,
+                    name: 'date_partition',
+                },
+            ],
+        },
+    },
+});
+```
+
+For full control, you can also configure sort orders and table properties:
+
+```ts
+// Build a table with partition spec, sort order, and table properties
+const advancedTable = new Table(scope, 'AdvancedTable', {
+    tableName: 'advanced_table',
+    namespace: namespace,
+    openTableFormat: OpenTableFormat.ICEBERG,
+    icebergMetadata: {
+        icebergSchema: {
+            schemaFieldList: [
+                { id: 1, name: 'event_date', type: 'date', required: true },
+                { id: 2, name: 'user_id', type: 'string', required: true },
+            ],
+        },
+        icebergPartitionSpec: {
+            specId: 0,
+            fields: [
+                {
+                    sourceId: 1,
+                    transform: IcebergTransform.IDENTITY,
+                    name: 'date_partition',
+                    fieldId: 1000,
+                },
+            ],
+        },
+        icebergSortOrder: {
+            orderId: 1,
+            fields: [
+                {
+                    sourceId: 1,
+                    transform: IcebergTransform.IDENTITY,
+                    direction: SortDirection.ASC,
+                    nullOrder: NullOrder.NULLS_LAST,
+                },
+            ],
+        },
+        tableProperties: [
+            { key: 'write.format.default', value: 'parquet' },
+        ],
+    },
+});
+```
+
 ### Controlling Table Bucket Permissions
 
 ```ts