> **Experimental**
>
> `@aws-cdk/aws-s3tables-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# IcebergPartitionSpec

Partition specification for Iceberg table.

Contains the complete partitioning configuration for a table, including all partition fields.
Use this to define multi-level partitioning (e.g., partition by date, then by region).

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/table.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0-alpha.0/packages/@aws-cdk/aws-s3tables-alpha/lib/table.ts#L449)

## Example

```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',
                },
            ],
        },
    },
});
```

## Properties

- `fields`: [IcebergPartitionField](/cdk/api/v2/docs/@aws-cdk_aws-s3tables-alpha.IcebergPartitionField.html)[] (required) — The list of partition fields.

- `specId`: number = 0 — The unique identifier for the partition specification.
