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

Partition field definition for Iceberg table.

Defines a single partition column. Multiple partition fields can be combined
in an IcebergPartitionSpec to create multi-level partitioning.

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

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as s3tables_alpha from '@aws-cdk/aws-s3tables-alpha';

declare const icebergTransform: s3tables_alpha.IcebergTransform;
const icebergPartitionField: s3tables_alpha.IcebergPartitionField = {
  name: 'name',
  sourceId: 123,
  transform: icebergTransform,

  // the properties below are optional
  fieldId: 123,
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_s3tables_alpha as s3tables_alpha

# iceberg_transform: s3tables_alpha.IcebergTransform

iceberg_partition_field = s3tables_alpha.IcebergPartitionField(
    name="name",
    source_id=123,
    transform=iceberg_transform,

    # the properties below are optional
    field_id=123
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.s3tables.alpha.*;

IcebergTransform icebergTransform;

IcebergPartitionField icebergPartitionField = IcebergPartitionField.builder()
        .name("name")
        .sourceId(123)
        .transform(icebergTransform)

        // the properties below are optional
        .fieldId(123)
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.S3Tables.Alpha
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.S3Tables.Alpha;

IcebergTransform icebergTransform;

var icebergPartitionField = new IcebergPartitionField {
    Name = "name",
    SourceId = 123,
    Transform = icebergTransform,

    // the properties below are optional
    FieldId = 123
};
```

Golang:

```go
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import s3tables_alpha "github.com/aws-samples/dummy/awscdkawss3tablesalpha"

var icebergTransform IcebergTransform

icebergPartitionField := &IcebergPartitionField{
	Name: jsii.String("name"),
	SourceId: jsii.Number(123),
	Transform: icebergTransform,

	// the properties below are optional
	FieldId: jsii.Number(123),
}
```

## Properties

- `fieldId`: number — The unique identifier for the partition field.

  **Default:** Auto-assigned starting from 1000

- `name`: string (required) — The name of the partition field.

- `sourceId`: number (required) — The source field ID from the schema.

- `transform`: [IcebergTransform](/cdk/api/v2/docs/@aws-cdk_aws-s3tables-alpha.IcebergTransform.html) (required) — The partition transform function.

  Use `IcebergTransform` static properties for common transforms (e.g., `IcebergTransform.IDENTITY`)
  or methods for parameterized transforms (e.g., `IcebergTransform.bucket(16)`).
