@aws-cdk/aws-s3tables-alpha 2.265.0-alpha.0 → 2.267.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.265.0",
+    "aws-cdk-lib": "^2.267.0",
     "constructs": "^10.5.0"
   },
   "dependencyClosure": {
@@ -9411,7 +9411,7 @@
   },
   "name": "@aws-cdk/aws-s3tables-alpha",
   "readme": {
-    "markdown": "# Amazon S3 Tables Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## Amazon S3 Tables\n\nAmazon S3 Tables deliver the first cloud object store with built-in Apache Iceberg support and streamline storing tabular data at scale.\n\n[Product Page](https://aws.amazon.com/s3/features/tables/) | [User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables.html)\n\n\n## Usage\n\n### Define an S3 Table Bucket\n\n```ts\n// Build a Table bucket\nconst sampleTableBucket = new TableBucket(scope, 'ExampleTableBucket', {\n    tableBucketName: 'example-bucket-1',\n    // optional fields:\n    unreferencedFileRemoval: {\n        status: UnreferencedFileRemovalStatus.ENABLED,\n        noncurrentDays: 20,\n        unreferencedDays: 20,\n    }\n});\n```\n\n### Define an S3 Tables Namespace\n\n```ts\n// Build a namespace\nconst sampleNamespace = new Namespace(scope, 'ExampleNamespace', {\n    namespaceName: 'example-namespace-1',\n    tableBucket: tableBucket,\n});\n```\n\n### Define an S3 Table\n\n```ts\n// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});\n```\n\nLearn 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)\n\n### Advanced Iceberg Table Configuration\n\nYou can configure partition specifications, sort orders, and table properties for optimized query performance.\n\nThe simplest way to add partitioning to your table:\n\n```ts\n// Build a table with partition spec (minimal configuration)\nconst partitionedTable = new Table(scope, 'PartitionedTable', {\n    tableName: 'partitioned_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { name: 'event_date', type: 'date', required: true },\n                { name: 'event_name', type: 'string' },\n            ],\n        },\n        icebergPartitionSpec: {\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                },\n            ],\n        },\n    },\n});\n```\n\nFor full control, you can also configure sort orders and table properties:\n\n```ts\n// Build a table with partition spec, sort order, and table properties\nconst advancedTable = new Table(scope, 'AdvancedTable', {\n    tableName: 'advanced_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { id: 1, name: 'event_date', type: 'date', required: true },\n                { id: 2, name: 'user_id', type: 'string', required: true },\n            ],\n        },\n        icebergPartitionSpec: {\n            specId: 0,\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                    fieldId: 1000,\n                },\n            ],\n        },\n        icebergSortOrder: {\n            orderId: 1,\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    direction: SortDirection.ASC,\n                    nullOrder: NullOrder.NULLS_LAST,\n                },\n            ],\n        },\n        tableProperties: [\n            { key: 'write.format.default', value: 'parquet' },\n        ],\n    },\n});\n```\n\n### Controlling Table Bucket Permissions\n\n```ts\n// Grant the principal read permissions to the bucket and all tables within\nconst accountId = '123456789012'\ntableBucket.grantRead(new iam.AccountPrincipal(accountId), '*');\n\n// Grant the role write permissions to the bucket and all tables within\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntableBucket.grantWrite(role, '*');\n\n// Grant the user read and write permissions to the bucket and all tables within\ntableBucket.grantReadWrite(new iam.User(stack, 'MyUser'), '*');\n\n// Grant permissions to the bucket and a particular table within it\nconst tableId = '6ba046b2-26de-44cf-9144-0c7862593a7b'\ntableBucket.grantReadWrite(new iam.AccountPrincipal(accountId), tableId);\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntableBucket.addToResourcePolicy(permissions);\n```\n\n### Controlling Table Bucket Encryption Settings\n\nS3 TableBuckets have SSE (server-side encryption with AES-256) enabled by default with S3 managed keys.\nYou can also bring your own KMS key for KMS-SSE or have S3 create a KMS key for you.\n\nIf a bucket is encrypted with KMS, grant functions on the bucket will also grant access\nto the TableBucket's associated KMS key.\n\n```ts\n// Provide a user defined KMS Key:\nconst key = new kms.Key(scope, 'UserKey', {});\nconst encryptedBucket = new TableBucket(scope, 'EncryptedTableBucket', {\n    tableBucketName: 'table-bucket-1',\n    encryption: TableBucketEncryption.KMS,\n    encryptionKey: key,\n});\n// This account principal will also receive kms:Decrypt access to the KMS key\nencryptedBucket.grantRead(new iam.AccountPrincipal('123456789012'), '*');\n\n// Use S3 managed server side encryption (default)\nconst encryptedBucketDefault = new TableBucket(scope, 'EncryptedTableBucketDefault', {\n    tableBucketName: 'table-bucket-3',\n    encryption: TableBucketEncryption.S3_MANAGED, // Uses AES-256 encryption by default\n});\n```\n\nWhen using KMS encryption (`TableBucketEncryption.KMS`), if no encryption key is provided, CDK will automatically create a new KMS key for the table bucket with necessary permissions.\n\n```ts\n// If no key is provided, one will be created automatically\nconst encryptedBucketAuto = new TableBucket(scope, 'EncryptedTableBucketAuto', {\n    tableBucketName: 'table-bucket-2',\n    encryption: TableBucketEncryption.KMS,\n});\n```\n\n### Enabling CloudWatch Request Metrics\n\nYou can enable CloudWatch request metrics for your table bucket. Request metrics provide insight into Amazon S3 Tables requests, helping you monitor and optimize your table bucket usage.\n\nFor more information about S3 Tables CloudWatch metrics, see the [S3 Tables CloudWatch Metrics documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-cloudwatch-metrics.html).\n\n```ts\n// Enable CloudWatch request metrics for the table bucket\nconst tableBucketWithMetrics = new TableBucket(scope, 'TableBucketWithMetrics', {\n    tableBucketName: 'metrics-enabled-bucket',\n    requestMetricsStatus: RequestMetricsStatus.ENABLED,\n});\n```\n\n### Controlling Table Permissions\n\n```ts\n// Grant the principal read permissions to the table\nconst accountId = '123456789012'\ntable.grantRead(new iam.AccountPrincipal(accountId));\n\n// Grant the role write permissions to the table\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntable.grantWrite(role);\n\n// Grant the user read and write permissions to the table\ntable.grantReadWrite(new iam.User(stack, 'MyUser'));\n\n// Grant an account permissions to the table\ntable.grantReadWrite(new iam.AccountPrincipal(accountId));\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntable.addToResourcePolicy(permissions);\n```\n\n### Tagging\n\nBoth `TableBucket` and `Table` support tagging through CDK's standard tagging mechanism:\n\n```ts\nTags.of(tableBucket).add('Environment', 'Production');\nTags.of(table).add('Team', 'DataEngineering');\n\n// Stack-level tags propagate to all resources\nTags.of(stack).add('Project', 'DataLake');\n```\n\n## Coming Soon\n\nL2 Construct support for:\n\n- KMS encryption support for Tables\n"
+    "markdown": "# Amazon S3 Tables Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## Amazon S3 Tables\n\nAmazon S3 Tables deliver the first cloud object store with built-in Apache Iceberg support and streamline storing tabular data at scale.\n\n[Product Page](https://aws.amazon.com/s3/features/tables/) | [User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables.html)\n\n\n## Usage\n\n### Define an S3 Table Bucket\n\n```ts\n// Build a Table bucket\nconst sampleTableBucket = new TableBucket(scope, 'ExampleTableBucket', {\n    tableBucketName: 'example-bucket-1',\n    // optional fields:\n    unreferencedFileRemoval: {\n        status: UnreferencedFileRemovalStatus.ENABLED,\n        noncurrentDays: 20,\n        unreferencedDays: 20,\n    }\n});\n```\n\n### Define an S3 Tables Namespace\n\n```ts\n// Build a namespace\nconst sampleNamespace = new Namespace(scope, 'ExampleNamespace', {\n    namespaceName: 'example-namespace-1',\n    tableBucket: tableBucket,\n});\n```\n\n### Define an S3 Table\n\n```ts\n// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});\n```\n\nLearn 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)\n\n### Advanced Iceberg Table Configuration\n\nYou can configure partition specifications, sort orders, and table properties for optimized query performance.\n\nThe simplest way to add partitioning to your table:\n\n```ts\n// Build a table with partition spec (minimal configuration)\nconst partitionedTable = new Table(scope, 'PartitionedTable', {\n    tableName: 'partitioned_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { name: 'event_date', type: 'date', required: true },\n                { name: 'event_name', type: 'string' },\n            ],\n        },\n        icebergPartitionSpec: {\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                },\n            ],\n        },\n    },\n});\n```\n\nFor full control, you can also configure sort orders and table properties:\n\n```ts\n// Build a table with partition spec, sort order, and table properties\nconst advancedTable = new Table(scope, 'AdvancedTable', {\n    tableName: 'advanced_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { id: 1, name: 'event_date', type: 'date', required: true },\n                { id: 2, name: 'user_id', type: 'string', required: true },\n            ],\n        },\n        icebergPartitionSpec: {\n            specId: 0,\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                    fieldId: 1000,\n                },\n            ],\n        },\n        icebergSortOrder: {\n            orderId: 1,\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    direction: SortDirection.ASC,\n                    nullOrder: NullOrder.NULLS_LAST,\n                },\n            ],\n        },\n        tableProperties: [\n            { key: 'write.format.default', value: 'parquet' },\n        ],\n    },\n});\n```\n\n### Controlling Table Bucket Permissions\n\n```ts\n// Grant the principal read permissions to the bucket and all tables within\nconst accountId = '123456789012'\ntableBucket.grantRead(new iam.AccountPrincipal(accountId), '*');\n\n// Grant the role write permissions to the bucket and all tables within\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntableBucket.grantWrite(role, '*');\n\n// Grant the user read and write permissions to the bucket and all tables within\ntableBucket.grantReadWrite(new iam.User(stack, 'MyUser'), '*');\n\n// Grant permissions to the bucket and a particular table within it\nconst tableId = '6ba046b2-26de-44cf-9144-0c7862593a7b'\ntableBucket.grantReadWrite(new iam.AccountPrincipal(accountId), tableId);\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntableBucket.addToResourcePolicy(permissions);\n```\n\n### Controlling Table Bucket Encryption Settings\n\nS3 TableBuckets have SSE (server-side encryption with AES-256) enabled by default with S3 managed keys.\nYou can also bring your own KMS key for KMS-SSE or have S3 create a KMS key for you.\n\nIf a bucket is encrypted with KMS, grant functions on the bucket will also grant access\nto the TableBucket's associated KMS key.\n\n```ts\n// Provide a user defined KMS Key:\nconst key = new kms.Key(scope, 'UserKey', {});\nconst encryptedBucket = new TableBucket(scope, 'EncryptedTableBucket', {\n    tableBucketName: 'table-bucket-1',\n    encryption: TableBucketEncryption.KMS,\n    encryptionKey: key,\n});\n// This account principal will also receive kms:Decrypt access to the KMS key\nencryptedBucket.grantRead(new iam.AccountPrincipal('123456789012'), '*');\n\n// Use S3 managed server side encryption (default)\nconst encryptedBucketDefault = new TableBucket(scope, 'EncryptedTableBucketDefault', {\n    tableBucketName: 'table-bucket-3',\n    encryption: TableBucketEncryption.S3_MANAGED, // Uses AES-256 encryption by default\n});\n```\n\nWhen using KMS encryption (`TableBucketEncryption.KMS`), if no encryption key is provided, CDK will automatically create a new KMS key for the table bucket with necessary permissions.\n\n```ts\n// If no key is provided, one will be created automatically\nconst encryptedBucketAuto = new TableBucket(scope, 'EncryptedTableBucketAuto', {\n    tableBucketName: 'table-bucket-2',\n    encryption: TableBucketEncryption.KMS,\n});\n```\n\n### Enabling CloudWatch Request Metrics\n\nYou can enable CloudWatch request metrics for your table bucket. Request metrics provide insight into Amazon S3 Tables requests, helping you monitor and optimize your table bucket usage.\n\nFor more information about S3 Tables CloudWatch metrics, see the [S3 Tables CloudWatch Metrics documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-cloudwatch-metrics.html).\n\n```ts\n// Enable CloudWatch request metrics for the table bucket\nconst tableBucketWithMetrics = new TableBucket(scope, 'TableBucketWithMetrics', {\n    tableBucketName: 'metrics-enabled-bucket',\n    requestMetricsStatus: RequestMetricsStatus.ENABLED,\n});\n```\n\n### Configuring Storage Class\n\nYou can configure the storage class for your table bucket and tables. Storage class determines how data is stored and billed, allowing you to optimize for different access patterns.\n\n```ts\n// Create a table bucket with INTELLIGENT_TIERING storage class\nconst tableBucketWithStorageClass = new TableBucket(scope, 'TableBucketWithStorageClass', {\n    tableBucketName: 'storage-class-bucket',\n    storageClass: StorageClass.INTELLIGENT_TIERING,\n});\n```\n\nTables inherit the storage class from their parent bucket by default. You can also override the storage class at the table level:\n\n```ts\n// Create a table with explicit storage class (overrides bucket default)\nconst tableWithStorageClass = new Table(scope, 'TableWithStorageClass', {\n    tableName: 'storage_class_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n    storageClass: StorageClass.STANDARD,\n});\n```\n\nAvailable storage classes:\n\n- `StorageClass.STANDARD` - For frequently accessed data\n- `StorageClass.INTELLIGENT_TIERING` - Automatically moves data between access tiers based on usage patterns\n\nNote: Table storage class is a create-only property and cannot be changed after the table is created.\n\n### Controlling Table Permissions\n\n```ts\n// Grant the principal read permissions to the table\nconst accountId = '123456789012'\ntable.grantRead(new iam.AccountPrincipal(accountId));\n\n// Grant the role write permissions to the table\nconst role = new iam.Role(stack, 'MyRole', { assumedBy: new iam.ServicePrincipal('sample') });\ntable.grantWrite(role);\n\n// Grant the user read and write permissions to the table\ntable.grantReadWrite(new iam.User(stack, 'MyUser'));\n\n// Grant an account permissions to the table\ntable.grantReadWrite(new iam.AccountPrincipal(accountId));\n\n// Add custom resource policy statements\nconst permissions = new iam.PolicyStatement({\n    effect: iam.Effect.ALLOW,\n    actions: ['s3tables:*'],\n    principals: [ new iam.ServicePrincipal('example.aws.internal') ],\n    resources: ['*']\n});\n\ntable.addToResourcePolicy(permissions);\n```\n\n### Tagging\n\nBoth `TableBucket` and `Table` support tagging through CDK's standard tagging mechanism:\n\n```ts\nTags.of(tableBucket).add('Environment', 'Production');\nTags.of(table).add('Team', 'DataEngineering');\n\n// Stack-level tags propagate to all resources\nTags.of(stack).add('Project', 'DataLake');\n```\n\n## Coming Soon\n\nL2 Construct support for:\n\n- KMS encryption support for Tables\n"
   },
   "repository": {
     "directory": "packages/@aws-cdk/aws-s3tables-alpha",
@@ -9461,7 +9461,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 260
+        "line": 273
       },
       "name": "CompactionProperty",
       "properties": [
@@ -9474,7 +9474,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 264
+            "line": 277
           },
           "name": "status",
           "type": {
@@ -9490,7 +9490,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 268
+            "line": 281
           },
           "name": "targetFileSizeMb",
           "type": {
@@ -9571,7 +9571,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 25
+        "line": 26
       },
       "methods": [
         {
@@ -9584,7 +9584,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 68
+            "line": 69
           },
           "name": "addToResourcePolicy",
           "parameters": [
@@ -9613,7 +9613,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 78
+            "line": 79
           },
           "name": "grantRead",
           "parameters": [
@@ -9642,7 +9642,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 100
+            "line": 101
           },
           "name": "grantReadWrite",
           "parameters": [
@@ -9671,7 +9671,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 89
+            "line": 90
           },
           "name": "grantWrite",
           "parameters": [
@@ -9706,7 +9706,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 30
+            "line": 31
           },
           "name": "tableArn",
           "type": {
@@ -9725,7 +9725,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 36
+            "line": 37
           },
           "name": "tableName",
           "type": {
@@ -9744,7 +9744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 42
+            "line": 43
           },
           "name": "account",
           "optional": true,
@@ -9764,7 +9764,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 48
+            "line": 49
           },
           "name": "region",
           "optional": true,
@@ -10052,7 +10052,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 514
+        "line": 527
       },
       "name": "IcebergMetadataProperty",
       "properties": [
@@ -10066,7 +10066,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 520
+            "line": 533
           },
           "name": "icebergSchema",
           "type": {
@@ -10083,7 +10083,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 527
+            "line": 540
           },
           "name": "icebergPartitionSpec",
           "optional": true,
@@ -10101,7 +10101,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 534
+            "line": 547
           },
           "name": "icebergSortOrder",
           "optional": true,
@@ -10120,7 +10120,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 542
+            "line": 555
           },
           "name": "tableProperties",
           "optional": true,
@@ -10152,7 +10152,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 404
+        "line": 417
       },
       "name": "IcebergPartitionField",
       "properties": [
@@ -10165,7 +10165,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 420
+            "line": 433
           },
           "name": "name",
           "type": {
@@ -10181,7 +10181,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 408
+            "line": 421
           },
           "name": "sourceId",
           "type": {
@@ -10198,7 +10198,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 416
+            "line": 429
           },
           "name": "transform",
           "type": {
@@ -10215,7 +10215,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 427
+            "line": 440
           },
           "name": "fieldId",
           "optional": true,
@@ -10242,7 +10242,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 436
+        "line": 449
       },
       "name": "IcebergPartitionSpec",
       "properties": [
@@ -10255,7 +10255,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 440
+            "line": 453
           },
           "name": "fields",
           "type": {
@@ -10277,7 +10277,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 447
+            "line": 460
           },
           "name": "specId",
           "optional": true,
@@ -10303,7 +10303,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 548
+        "line": 561
       },
       "name": "IcebergSchemaProperty",
       "properties": [
@@ -10316,7 +10316,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 552
+            "line": 565
           },
           "name": "schemaFieldList",
           "type": {
@@ -10346,7 +10346,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 453
+        "line": 466
       },
       "name": "IcebergSortField",
       "properties": [
@@ -10359,7 +10359,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 470
+            "line": 483
           },
           "name": "direction",
           "type": {
@@ -10375,7 +10375,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 475
+            "line": 488
           },
           "name": "nullOrder",
           "type": {
@@ -10391,7 +10391,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 457
+            "line": 470
           },
           "name": "sourceId",
           "type": {
@@ -10408,7 +10408,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 465
+            "line": 478
           },
           "name": "transform",
           "type": {
@@ -10433,7 +10433,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 481
+        "line": 494
       },
       "name": "IcebergSortOrder",
       "properties": [
@@ -10446,7 +10446,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 485
+            "line": 498
           },
           "name": "fields",
           "type": {
@@ -10468,7 +10468,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 492
+            "line": 505
           },
           "name": "orderId",
           "optional": true,
@@ -10493,7 +10493,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 288
+        "line": 301
       },
       "methods": [
         {
@@ -10503,7 +10503,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 319
+            "line": 332
           },
           "name": "bucket",
           "parameters": [
@@ -10531,7 +10531,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 349
+            "line": 362
           },
           "name": "of",
           "parameters": [
@@ -10559,7 +10559,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 334
+            "line": 347
           },
           "name": "truncate",
           "parameters": [
@@ -10587,7 +10587,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 365
+            "line": 378
           },
           "name": "toString",
           "returns": {
@@ -10608,7 +10608,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 307
+            "line": 320
           },
           "name": "DAY",
           "static": true,
@@ -10625,7 +10625,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 312
+            "line": 325
           },
           "name": "HOUR",
           "static": true,
@@ -10642,7 +10642,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 292
+            "line": 305
           },
           "name": "IDENTITY",
           "static": true,
@@ -10659,7 +10659,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 302
+            "line": 315
           },
           "name": "MONTH",
           "static": true,
@@ -10676,7 +10676,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 297
+            "line": 310
           },
           "name": "YEAR",
           "static": true,
@@ -10692,7 +10692,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 356
+            "line": 369
           },
           "name": "value",
           "type": {
@@ -11011,7 +11011,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 387
+        "line": 400
       },
       "members": [
         {
@@ -11042,7 +11042,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 248
+        "line": 261
       },
       "members": [
         {
@@ -11106,7 +11106,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 558
+        "line": 571
       },
       "name": "SchemaFieldProperty",
       "properties": [
@@ -11119,7 +11119,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 569
+            "line": 582
           },
           "name": "name",
           "type": {
@@ -11136,7 +11136,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 585
+            "line": 598
           },
           "name": "type",
           "type": {
@@ -11153,7 +11153,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 564
+            "line": 577
           },
           "name": "id",
           "optional": true,
@@ -11172,7 +11172,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 578
+            "line": 591
           },
           "name": "required",
           "optional": true,
@@ -11200,7 +11200,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 595
+        "line": 608
       },
       "name": "SnapshotManagementProperty",
       "properties": [
@@ -11214,7 +11214,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 601
+            "line": 614
           },
           "name": "maxSnapshotAgeHours",
           "optional": true,
@@ -11232,7 +11232,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 608
+            "line": 621
           },
           "name": "minSnapshotsToKeep",
           "optional": true,
@@ -11250,7 +11250,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 615
+            "line": 628
           },
           "name": "status",
           "optional": true,
@@ -11275,7 +11275,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 373
+        "line": 386
       },
       "members": [
         {
@@ -11310,7 +11310,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 274
+        "line": 287
       },
       "members": [
         {
@@ -11331,13 +11331,51 @@
       "name": "Status",
       "symbolId": "lib/table:Status"
     },
+    "@aws-cdk/aws-s3tables-alpha.StorageClass": {
+      "assembly": "@aws-cdk/aws-s3tables-alpha",
+      "docs": {
+        "remarks": "Determines the storage tier used for table data, allowing optimization\nfor different access patterns and cost profiles.",
+        "stability": "experimental",
+        "summary": "Storage class for S3 Tables.",
+        "example": "// Create a table bucket with INTELLIGENT_TIERING storage class\nconst tableBucketWithStorageClass = new TableBucket(scope, 'TableBucketWithStorageClass', {\n    tableBucketName: 'storage-class-bucket',\n    storageClass: StorageClass.INTELLIGENT_TIERING,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-s3tables-alpha.StorageClass",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "lib/table-bucket.ts",
+        "line": 171
+      },
+      "members": [
+        {
+          "docs": {
+            "remarks": "Use this for tables with consistent, high-frequency access patterns.",
+            "stability": "experimental",
+            "summary": "Standard storage class for frequently accessed data."
+          },
+          "name": "STANDARD"
+        },
+        {
+          "docs": {
+            "remarks": "Use this for tables with unknown or changing access patterns to optimize costs\nwhile maintaining performance for frequently accessed data.",
+            "stability": "experimental",
+            "summary": "Intelligent-Tiering storage class that automatically moves data between access tiers."
+          },
+          "name": "INTELLIGENT_TIERING"
+        }
+      ],
+      "name": "StorageClass",
+      "symbolId": "lib/table-bucket:StorageClass"
+    },
     "@aws-cdk/aws-s3tables-alpha.Table": {
       "assembly": "@aws-cdk/aws-s3tables-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
         "stability": "experimental",
         "summary": "An S3 Table with helpers.",
-        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "example": "// Build a table with partition spec (minimal configuration)\nconst partitionedTable = new Table(scope, 'PartitionedTable', {\n    tableName: 'partitioned_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { name: 'event_date', type: 'date', required: true },\n                { name: 'event_name', type: 'string' },\n            ],\n        },\n        icebergPartitionSpec: {\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                },\n            ],\n        },\n    },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -11349,7 +11387,7 @@
         },
         "locationInModule": {
           "filename": "lib/table.ts",
-          "line": 766
+          "line": 779
         },
         "parameters": [
           {
@@ -11379,7 +11417,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 639
+        "line": 652
       },
       "methods": [
         {
@@ -11389,7 +11427,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 651
+            "line": 664
           },
           "name": "fromTableAttributes",
           "parameters": [
@@ -11438,7 +11476,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 684
+            "line": 697
           },
           "name": "validateTableName",
           "parameters": [
@@ -11462,7 +11500,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 124
+            "line": 125
           },
           "name": "addToResourcePolicy",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11487,7 +11525,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 145
+            "line": 146
           },
           "name": "grantRead",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11512,7 +11550,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 167
+            "line": 168
           },
           "name": "grantReadWrite",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11537,7 +11575,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 156
+            "line": 157
           },
           "name": "grantWrite",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11567,7 +11605,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 642
+            "line": 655
           },
           "name": "PROPERTY_INJECTION_ID",
           "static": true,
@@ -11583,7 +11621,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 747
+            "line": 760
           },
           "name": "cdkTagManager",
           "overrides": "aws-cdk-lib.ITaggableV2",
@@ -11599,7 +11637,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 757
+            "line": 770
           },
           "name": "namespace",
           "type": {
@@ -11614,7 +11652,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 736
+            "line": 749
           },
           "name": "tableArn",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11630,7 +11668,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 752
+            "line": 765
           },
           "name": "tableName",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITable",
@@ -11646,7 +11684,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 762
+            "line": 775
           },
           "name": "tablePolicy",
           "optional": true,
@@ -11661,7 +11699,7 @@
           },
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 764
+            "line": 777
           },
           "name": "autoCreatePolicy",
           "protected": true,
@@ -11688,7 +11726,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 624
+        "line": 637
       },
       "name": "TableAttributes",
       "properties": [
@@ -11701,7 +11739,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 633
+            "line": 646
           },
           "name": "tableArn",
           "type": {
@@ -11717,7 +11755,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 628
+            "line": 641
           },
           "name": "tableName",
           "type": {
@@ -11746,7 +11784,7 @@
         },
         "locationInModule": {
           "filename": "lib/table-bucket.ts",
-          "line": 613
+          "line": 646
         },
         "parameters": [
           {
@@ -11776,7 +11814,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/table-bucket.ts",
-        "line": 434
+        "line": 467
       },
       "methods": [
         {
@@ -11786,7 +11824,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 446
+            "line": 479
           },
           "name": "fromTableBucketArn",
           "parameters": [
@@ -11832,7 +11870,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 457
+            "line": 490
           },
           "name": "fromTableBucketAttributes",
           "parameters": [
@@ -11879,7 +11917,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 493
+            "line": 526
           },
           "name": "validateTableBucketName",
           "parameters": [
@@ -11903,7 +11941,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 550
+            "line": 583
           },
           "name": "validateUnreferencedFileRemoval",
           "parameters": [
@@ -11929,7 +11967,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 221
+            "line": 244
           },
           "name": "addToResourcePolicy",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -11957,7 +11995,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 241
+            "line": 264
           },
           "name": "grantRead",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -11988,7 +12026,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 267
+            "line": 290
           },
           "name": "grantReadWrite",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -12019,7 +12057,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 254
+            "line": 277
           },
           "name": "grantWrite",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -12055,7 +12093,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 437
+            "line": 470
           },
           "name": "PROPERTY_INJECTION_ID",
           "static": true,
@@ -12071,7 +12109,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 602
+            "line": 635
           },
           "name": "cdkTagManager",
           "overrides": "aws-cdk-lib.ITaggableV2",
@@ -12087,7 +12125,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 652
+            "line": 686
           },
           "name": "tableBucketArn",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -12103,7 +12141,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 644
+            "line": 678
           },
           "name": "tableBucketName",
           "overrides": "@aws-cdk/aws-s3tables-alpha.ITableBucket",
@@ -12119,7 +12157,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 609
+            "line": 642
           },
           "name": "encryptionKey",
           "optional": true,
@@ -12136,7 +12174,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 607
+            "line": 640
           },
           "name": "tableBucketPolicy",
           "optional": true,
@@ -12151,7 +12189,7 @@
           },
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 611
+            "line": 644
           },
           "name": "autoCreatePolicy",
           "protected": true,
@@ -12178,7 +12216,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table-bucket.ts",
-        "line": 385
+        "line": 418
       },
       "name": "TableBucketAttributes",
       "properties": [
@@ -12192,7 +12230,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 396
+            "line": 429
           },
           "name": "account",
           "optional": true,
@@ -12210,7 +12248,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 414
+            "line": 447
           },
           "name": "encryptionKey",
           "optional": true,
@@ -12228,7 +12266,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 390
+            "line": 423
           },
           "name": "region",
           "optional": true,
@@ -12246,7 +12284,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 408
+            "line": 441
           },
           "name": "tableBucketArn",
           "optional": true,
@@ -12264,7 +12302,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 402
+            "line": 435
           },
           "name": "tableBucketName",
           "optional": true,
@@ -12289,7 +12327,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/table-bucket.ts",
-        "line": 168
+        "line": 191
       },
       "members": [
         {
@@ -12483,7 +12521,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table-bucket.ts",
-        "line": 311
+        "line": 334
       },
       "name": "TableBucketProps",
       "properties": [
@@ -12499,7 +12537,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 316
+            "line": 339
           },
           "name": "tableBucketName",
           "type": {
@@ -12516,7 +12554,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 338
+            "line": 361
           },
           "name": "account",
           "optional": true,
@@ -12535,7 +12573,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 348
+            "line": 371
           },
           "name": "encryption",
           "optional": true,
@@ -12554,7 +12592,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 359
+            "line": 382
           },
           "name": "encryptionKey",
           "optional": true,
@@ -12572,7 +12610,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 331
+            "line": 354
           },
           "name": "region",
           "optional": true,
@@ -12590,7 +12628,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 366
+            "line": 389
           },
           "name": "removalPolicy",
           "optional": true,
@@ -12609,7 +12647,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 376
+            "line": 399
           },
           "name": "requestMetricsStatus",
           "optional": true,
@@ -12617,6 +12655,25 @@
             "fqn": "@aws-cdk/aws-s3tables-alpha.RequestMetricsStatus"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- STANDARD storage class",
+            "remarks": "Determines the storage tier used for table data, allowing optimization\nfor different access patterns and cost profiles.",
+            "stability": "experimental",
+            "summary": "The storage class for the table bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table-bucket.ts",
+            "line": 409
+          },
+          "name": "storageClass",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.StorageClass"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -12631,7 +12688,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table-bucket.ts",
-            "line": 324
+            "line": 347
           },
           "name": "unreferencedFileRemoval",
           "optional": true,
@@ -12815,7 +12872,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 498
+        "line": 511
       },
       "name": "TablePropertyEntry",
       "properties": [
@@ -12828,7 +12885,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 502
+            "line": 515
           },
           "name": "key",
           "type": {
@@ -12844,7 +12901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 507
+            "line": 520
           },
           "name": "value",
           "type": {
@@ -12860,7 +12917,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Properties for creating a new S3 Table.",
-        "example": "// Build a table\nconst sampleTable = new Table(scope, 'ExampleTable', {\n    tableName: 'example_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    withoutMetadata: true,\n});\n\n// Build a table with an Iceberg Schema\nconst sampleTableWithSchema = new Table(scope, 'ExampleSchemaTable', {\n    tableName: 'example_table_with_schema',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n            {\n                name: 'id',\n                type: 'int',\n                required: true,\n            },\n            {\n                name: 'name',\n                type: 'string',\n            },\n            ],\n        },\n    },\n    compaction: {\n        status: Status.ENABLED,\n        targetFileSizeMb: 128,\n    },\n    snapshotManagement: {\n        status: Status.ENABLED,\n        maxSnapshotAgeHours: 48,\n        minSnapshotsToKeep: 5,\n    },\n});",
+        "example": "// Build a table with partition spec (minimal configuration)\nconst partitionedTable = new Table(scope, 'PartitionedTable', {\n    tableName: 'partitioned_table',\n    namespace: namespace,\n    openTableFormat: OpenTableFormat.ICEBERG,\n    icebergMetadata: {\n        icebergSchema: {\n            schemaFieldList: [\n                { name: 'event_date', type: 'date', required: true },\n                { name: 'event_name', type: 'string' },\n            ],\n        },\n        icebergPartitionSpec: {\n            fields: [\n                {\n                    sourceId: 1,\n                    transform: IcebergTransform.IDENTITY,\n                    name: 'date_partition',\n                },\n            ],\n        },\n    },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -12869,7 +12926,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/table.ts",
-        "line": 200
+        "line": 201
       },
       "name": "TableProps",
       "properties": [
@@ -12882,7 +12939,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 208
+            "line": 209
           },
           "name": "namespace",
           "type": {
@@ -12899,7 +12956,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 212
+            "line": 213
           },
           "name": "openTableFormat",
           "type": {
@@ -12915,7 +12972,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 204
+            "line": 205
           },
           "name": "tableName",
           "type": {
@@ -12933,7 +12990,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 218
+            "line": 219
           },
           "name": "compaction",
           "optional": true,
@@ -12951,7 +13008,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 223
+            "line": 224
           },
           "name": "icebergMetadata",
           "optional": true,
@@ -12969,7 +13026,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 234
+            "line": 235
           },
           "name": "removalPolicy",
           "optional": true,
@@ -12987,7 +13044,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 228
+            "line": 229
           },
           "name": "snapshotManagement",
           "optional": true,
@@ -12995,6 +13052,25 @@
             "fqn": "@aws-cdk/aws-s3tables-alpha.SnapshotManagementProperty"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Inherits from the table bucket's storage class configuration",
+            "remarks": "Determines the storage tier used for table data, allowing optimization\nfor different access patterns and cost profiles.\n\nNote: This is a create-only property and cannot be changed after the table is created.",
+            "stability": "experimental",
+            "summary": "The storage class for the table."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/table.ts",
+            "line": 255
+          },
+          "name": "storageClass",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-s3tables-alpha.StorageClass"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -13006,7 +13082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/table.ts",
-            "line": 242
+            "line": 243
           },
           "name": "withoutMetadata",
           "optional": true,
@@ -13135,6 +13211,6 @@
       "symbolId": "lib/table-bucket:UnreferencedFileRemovalStatus"
     }
   },
-  "version": "2.265.0-alpha.0",
+  "version": "2.267.0-alpha.0",
   "fingerprint": "**********"
 }