feat: support L2 constructs for Amazon S3 Tables #33599

xuxey · 2025-02-27T00:46:04Z

Reason for this change

This adds an alpha module @aws-cdk/aws-s3tables-alpha containing L2 constructs for Amazon S3 Tables.

Description of changes

Amazon S3 Tables deliver the first cloud object store with built-in Apache Iceberg support and streamline storing tabular data at scale. See product page.

These changes set up an alpha module for higher level L2 constructs for S3 Tables:

TableBucket: defines an underlying CfnTableBucket resource
TableBucketPolicy: defines an underlying CfnTableBucketPolicy resource

Example Usage

Define an S3 Table Bucket

// Build a Table bucket
const tableBucket = new TableBucket(scope, 'ExampleTableBucket', {
    tableBucketName: 'example-bucket-1',
    // optional fields:
    unreferencedFileRemoval: {
        noncurrentDays: 123,
        status: 'Enabled',
        unreferencedDays: 123,
    },
});

  // Add resource policy statements
const permissions = new iam.PolicyStatement({
    effect: Effect.ALLOW,
    actions: ['s3tables:*'],
    principals: [ new iam.ServicePrincipal('example.awsamazon.com') ],
    resources: ['*']
});

tableBucket.addResourcePolicy(permissions);

Future constructs are planned to be supported incrementally.

Describe any new or updated permissions being added

N/A

Description of how you validated changes

Unit tests for all major code branches and snapshot integration tests have been added

Checklist

[✔] My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

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

cr: https://code.amazon.com/reviews/CR-179393336

cr: https://code.amazon.com/reviews/CR-179525855

aws-cdk-automation

(This review is outdated)

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

codecov · 2025-03-06T22:18:41Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 82.37%. Comparing base (3de0818) to head (10616f7).

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #33599   +/-   ##
=======================================
  Coverage   82.37%   82.37%           
=======================================
  Files         120      120           
  Lines        6933     6933           
  Branches     1169     1169           
=======================================
  Hits         5711     5711           
  Misses       1119     1119           
  Partials      103      103

Flag	Coverage Δ
suite.unit	`82.37% <ø> (ø)`

Flags with carried forward coverage won't be shown. Click here to find out more.

Components	Coverage Δ
packages/aws-cdk	`∅ <ø> (∅)`
packages/aws-cdk-lib/core	`82.37% <ø> (ø)`

🚀 New features to boost your workflow:

❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

godwingrs22

Thanks @xuxey for the great work on the TableBucket and TableBucketPolicy L2 constructs. Left some feedback and suggestions around adding permissions with grant methods to align with the CDK pattern.