---
id: aws-cdk-aws-s3tables-alpha
version: "2.265.0a0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-s3tables-alpha — CDK Constructs for S3 Tables

License: permissive · Maintenance: active · Downloads: 518.0K/mo

## What it is and what it does

This package provides high-level AWS CDK constructs for provisioning and managing S3 Tables, AWS's cloud object store with native Apache Iceberg table format support. It lets you define table buckets, namespaces, and individual tables using Python code, with full control over schema, partitioning, sort orders, and lifecycle policies like unreferenced file removal and snapshot management.

The constructs wrap the underlying S3 Tables API and integrate with CDK's permission and encryption systems, allowing you to grant IAM principals read/write access and configure KMS or S3-managed encryption in declarative code. Because the APIs are experimental and subject to breaking changes, it is best suited for teams actively tracking AWS S3 Tables development and willing to update code as the service matures.

Use it for:

- Define and deploy S3 table buckets with automatic cleanup of unreferenced files and snapshot retention policies.
- Create Iceberg tables with custom schemas, partitioning strategies, and sort orders for optimized analytical queries.
- Grant fine-grained IAM permissions to table buckets and individual tables for multi-tenant or cross-account access.
- Configure encryption settings (KMS or S3-managed) and manage key access alongside table infrastructure.
- Manage table namespaces and organize multiple related tables within a single bucket using infrastructure-as-code.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides AWS CDK constructs for defining and managing Amazon S3 Tables with built-in Apache Iceberg support, enabling declarative infrastructure-as-code for tabular data storage in S3.

Yes, if you are actively using AWS CDK to manage S3 infrastructure and need to provision S3 Tables with Iceberg support. The package is actively maintained, has no known vulnerabilities, and low install friction. However, be aware that the APIs are experimental and subject to breaking changes between releases—unsuitable for projects requiring strict backward compatibility. For production use, plan for version pinning and regular testing of upgrades.

## Install

pip install aws-cdk-aws-s3tables-alpha
uv add aws-cdk-aws-s3tables-alpha
poetry add aws-cdk-aws-s3tables-alpha

## Installing aws-cdk.aws-s3tables-alpha

Before you install: Active maintenance with a recent release; low install friction and four runtime dependencies all from the AWS CDK ecosystem. The package is marked experimental and subject to non-backward-compatible changes, so expect breaking updates between versions.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions—suitable for most production and open-source projects.

Quickstart:

pip install aws-cdk.aws-s3tables-alpha

from aws_cdk.aws_s3tables_alpha import TableBucket, UnreferencedFileRemoval, UnreferencedFileRemovalStatus

sample_table_bucket = TableBucket(scope, "ExampleTableBucket",
    table_bucket_name="example-bucket-1",
    unreferenced_file_removal=UnreferencedFileRemoval(
        status=UnreferencedFileRemovalStatus.ENABLED,
        noncurrent_days=20,
        unreferenced_days=20
    )
)

Requires Python 3.10 or later; intended for use within an AWS CDK application stack context.

Verify before relying:

- Whether breaking changes between alpha versions require code updates in practice and how frequently they occur.
- Performance characteristics and scalability limits for large numbers of tables or namespaces.
- Compatibility with non-Python CDK languages and cross-language construct usage patterns.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 518.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws cdk s3 tables, iceberg table bucket constructs, s3 tables infrastructure as code, apache iceberg cdk, s3 table namespace management, tabular data s3 storage, cdk s3 table permissions, aws-cdk, infrastructure-as-code, iceberg

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-s3tables-alpha) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-s3tables-alpha/)