aws-cdk.aws-s3tables-alpha 2.196.0a0__tar.gz → 2.232.2a0__tar.gz

{aws_cdk_aws_s3tables_alpha-2.196.0a0/src/aws_cdk.aws_s3tables_alpha.egg-info → aws_cdk_aws_s3tables_alpha-2.232.2a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk.aws-s3tables-alpha
-Version: 2.196.0a0
+Version: 2.232.2a0
 Summary: CDK Constructs for S3 Tables
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services
@@ -22,11 +22,11 @@ Requires-Python: ~=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: aws-cdk-lib<3.0.0,>=2.196.0
+Requires-Dist: aws-cdk-lib<3.0.0,>=2.232.2
 Requires-Dist: constructs<11.0.0,>=10.0.0
-Requires-Dist: jsii<2.0.0,>=1.112.0
+Requires-Dist: jsii<2.0.0,>=1.120.0
 Requires-Dist: publication>=0.0.3
-Requires-Dist: typeguard<4.3.0,>=2.13.3
+Requires-Dist: typeguard==2.13.3
 
 # Amazon S3 Tables Construct Library
 
@@ -67,6 +67,57 @@ sample_table_bucket = TableBucket(scope, "ExampleTableBucket",
 )
 ```
 
+### Define an S3 Tables Namespace
+
+```python
+# Build a namespace
+sample_namespace = Namespace(scope, "ExampleNamespace",
+    namespace_name="example-namespace-1",
+    table_bucket=table_bucket
+)
+```
+
+### Define an S3 Table
+
+```python
+# Build a table
+sample_table = Table(scope, "ExampleTable",
+    table_name="example_table",
+    namespace=namespace,
+    open_table_format=OpenTableFormat.ICEBERG,
+    without_metadata=True
+)
+
+# Build a table with an Iceberg Schema
+sample_table_with_schema = Table(scope, "ExampleSchemaTable",
+    table_name="example_table_with_schema",
+    namespace=namespace,
+    open_table_format=OpenTableFormat.ICEBERG,
+    iceberg_metadata=IcebergMetadataProperty(
+        iceberg_schema=IcebergSchemaProperty(
+            schema_field_list=[SchemaFieldProperty(
+                name="id",
+                type="int",
+                required=True
+            ), SchemaFieldProperty(
+                name="name",
+                type="string"
+            )
+            ]
+        )
+    ),
+    compaction=CompactionProperty(
+        status=Status.ENABLED,
+        target_file_size_mb=128
+    ),
+    snapshot_management=SnapshotManagementProperty(
+        status=Status.ENABLED,
+        max_snapshot_age_hours=48,
+        min_snapshots_to_keep=5
+    )
+)
+```
+
 Learn 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)
 
 ### Controlling Table Bucket Permissions
@@ -134,9 +185,36 @@ encrypted_bucket_auto = TableBucket(scope, "EncryptedTableBucketAuto",
 )
 ```
 
+### Controlling Table Permissions
+
+```python
+# Grant the principal read permissions to the table
+account_id = "123456789012"
+table.grant_read(iam.AccountPrincipal(account_id))
+
+# Grant the role write permissions to the table
+role = iam.Role(stack, "MyRole", assumed_by=iam.ServicePrincipal("sample"))
+table.grant_write(role)
+
+# Grant the user read and write permissions to the table
+table.grant_read_write(iam.User(stack, "MyUser"))
+
+# Grant an account permissions to the table
+table.grant_read_write(iam.AccountPrincipal(account_id))
+
+# Add custom resource policy statements
+permissions = iam.PolicyStatement(
+    effect=iam.Effect.ALLOW,
+    actions=["s3tables:*"],
+    principals=[iam.ServicePrincipal("example.aws.internal")],
+    resources=["*"]
+)
+
+table.add_to_resource_policy(permissions)
+```
+
 ## Coming Soon
 
 L2 Construct support for:
 
-* Namespaces
-* Tables
+* KMS encryption support for Tables

{aws_cdk_aws_s3tables_alpha-2.196.0a0 → aws_cdk_aws_s3tables_alpha-2.232.2a0}/README.md

@@ -37,6 +37,57 @@ sample_table_bucket = TableBucket(scope, "ExampleTableBucket",
 )
 ```
 
+### Define an S3 Tables Namespace
+
+```python
+# Build a namespace
+sample_namespace = Namespace(scope, "ExampleNamespace",
+    namespace_name="example-namespace-1",
+    table_bucket=table_bucket
+)
+```
+
+### Define an S3 Table
+
+```python
+# Build a table
+sample_table = Table(scope, "ExampleTable",
+    table_name="example_table",
+    namespace=namespace,
+    open_table_format=OpenTableFormat.ICEBERG,
+    without_metadata=True
+)
+
+# Build a table with an Iceberg Schema
+sample_table_with_schema = Table(scope, "ExampleSchemaTable",
+    table_name="example_table_with_schema",
+    namespace=namespace,
+    open_table_format=OpenTableFormat.ICEBERG,
+    iceberg_metadata=IcebergMetadataProperty(
+        iceberg_schema=IcebergSchemaProperty(
+            schema_field_list=[SchemaFieldProperty(
+                name="id",
+                type="int",
+                required=True
+            ), SchemaFieldProperty(
+                name="name",
+                type="string"
+            )
+            ]
+        )
+    ),
+    compaction=CompactionProperty(
+        status=Status.ENABLED,
+        target_file_size_mb=128
+    ),
+    snapshot_management=SnapshotManagementProperty(
+        status=Status.ENABLED,
+        max_snapshot_age_hours=48,
+        min_snapshots_to_keep=5
+    )
+)
+```
+
 Learn 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)
 
 ### Controlling Table Bucket Permissions
@@ -104,9 +155,36 @@ encrypted_bucket_auto = TableBucket(scope, "EncryptedTableBucketAuto",
 )
 ```
 
+### Controlling Table Permissions
+
+```python
+# Grant the principal read permissions to the table
+account_id = "123456789012"
+table.grant_read(iam.AccountPrincipal(account_id))
+
+# Grant the role write permissions to the table
+role = iam.Role(stack, "MyRole", assumed_by=iam.ServicePrincipal("sample"))
+table.grant_write(role)
+
+# Grant the user read and write permissions to the table
+table.grant_read_write(iam.User(stack, "MyUser"))
+
+# Grant an account permissions to the table
+table.grant_read_write(iam.AccountPrincipal(account_id))
+
+# Add custom resource policy statements
+permissions = iam.PolicyStatement(
+    effect=iam.Effect.ALLOW,
+    actions=["s3tables:*"],
+    principals=[iam.ServicePrincipal("example.aws.internal")],
+    resources=["*"]
+)
+
+table.add_to_resource_policy(permissions)
+```
+
 ## Coming Soon
 
 L2 Construct support for:
 
-* Namespaces
-* Tables
+* KMS encryption support for Tables

{aws_cdk_aws_s3tables_alpha-2.196.0a0 → aws_cdk_aws_s3tables_alpha-2.232.2a0}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools~=75.3.2", "wheel~=0.42"]
+requires = ["setuptools~=75.3.2", "build~=1.3.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.pyright]

{aws_cdk_aws_s3tables_alpha-2.196.0a0 → aws_cdk_aws_s3tables_alpha-2.232.2a0}/setup.py

@@ -5,7 +5,7 @@ kwargs = json.loads(
     """
 {
     "name": "aws-cdk.aws-s3tables-alpha",
-    "version": "2.196.0.a0",
+    "version": "2.232.2.a0",
     "description": "CDK Constructs for S3 Tables",
     "license": "Apache-2.0",
     "url": "https://github.com/aws/aws-cdk",
@@ -26,7 +26,7 @@ kwargs = json.loads(
     ],
     "package_data": {
         "aws_cdk.aws_s3tables_alpha._jsii": [
-            "aws-s3tables-alpha@2.196.0-alpha.0.jsii.tgz"
+            "aws-s3tables-alpha@2.232.2-alpha.0.jsii.tgz"
         ],
         "aws_cdk.aws_s3tables_alpha": [
             "py.typed"
@@ -34,11 +34,11 @@ kwargs = json.loads(
     },
     "python_requires": "~=3.9",
     "install_requires": [
-        "aws-cdk-lib>=2.196.0, <3.0.0",
+        "aws-cdk-lib>=2.232.2, <3.0.0",
         "constructs>=10.0.0, <11.0.0",
-        "jsii>=1.112.0, <2.0.0",
+        "jsii>=1.120.0, <2.0.0",
         "publication>=0.0.3",
-        "typeguard>=2.13.3,<4.3.0"
+        "typeguard==2.13.3"
     ],
     "classifiers": [
         "Intended Audience :: Developers",