aws-cdk.aws-s3tables-alpha 2.207.0a0__py3-none-any.whl → 2.223.0a0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -33,9 +33,9 @@ import constructs._jsii
33
33
 
34
34
  __jsii_assembly__ = jsii.JSIIAssembly.load(
35
35
  "@aws-cdk/aws-s3tables-alpha",
36
- "2.207.0-alpha.0",
36
+ "2.223.0-alpha.0",
37
37
  __name__[0:-6],
38
- "aws-s3tables-alpha@2.207.0-alpha.0.jsii.tgz",
38
+ "aws-s3tables-alpha@2.223.0-alpha.0.jsii.tgz",
39
39
  )
40
40
 
41
41
  __all__ = [
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: aws-cdk.aws-s3tables-alpha
3
- Version: 2.207.0a0
3
+ Version: 2.223.0a0
4
4
  Summary: CDK Constructs for S3 Tables
5
5
  Home-page: https://github.com/aws/aws-cdk
6
6
  Author: Amazon Web Services
@@ -22,11 +22,11 @@ Requires-Python: ~=3.9
22
22
  Description-Content-Type: text/markdown
23
23
  License-File: LICENSE
24
24
  License-File: NOTICE
25
- Requires-Dist: aws-cdk-lib<3.0.0,>=2.207.0
26
- Requires-Dist: constructs<11.0.0,>=10.0.0
27
- Requires-Dist: jsii<2.0.0,>=1.112.0
28
- Requires-Dist: publication>=0.0.3
29
- Requires-Dist: typeguard<4.3.0,>=2.13.3
25
+ Requires-Dist: aws-cdk-lib <3.0.0,>=2.223.0
26
+ Requires-Dist: constructs <11.0.0,>=10.0.0
27
+ Requires-Dist: jsii <2.0.0,>=1.118.0
28
+ Requires-Dist: publication >=0.0.3
29
+ Requires-Dist: typeguard <4.3.0,>=2.13.3
30
30
 
31
31
  # Amazon S3 Tables Construct Library
32
32
 
@@ -67,6 +67,57 @@ sample_table_bucket = TableBucket(scope, "ExampleTableBucket",
67
67
  )
68
68
  ```
69
69
 
70
+ ### Define an S3 Tables Namespace
71
+
72
+ ```python
73
+ # Build a namespace
74
+ sample_namespace = Namespace(scope, "ExampleNamespace",
75
+ namespace_name="example-namespace-1",
76
+ table_bucket=table_bucket
77
+ )
78
+ ```
79
+
80
+ ### Define an S3 Table
81
+
82
+ ```python
83
+ # Build a table
84
+ sample_table = Table(scope, "ExampleTable",
85
+ table_name="example_table",
86
+ namespace=namespace,
87
+ open_table_format=OpenTableFormat.ICEBERG,
88
+ without_metadata=True
89
+ )
90
+
91
+ # Build a table with an Iceberg Schema
92
+ sample_table_with_schema = Table(scope, "ExampleSchemaTable",
93
+ table_name="example_table_with_schema",
94
+ namespace=namespace,
95
+ open_table_format=OpenTableFormat.ICEBERG,
96
+ iceberg_metadata=IcebergMetadataProperty(
97
+ iceberg_schema=IcebergSchemaProperty(
98
+ schema_field_list=[SchemaFieldProperty(
99
+ name="id",
100
+ type="int",
101
+ required=True
102
+ ), SchemaFieldProperty(
103
+ name="name",
104
+ type="string"
105
+ )
106
+ ]
107
+ )
108
+ ),
109
+ compaction=CompactionProperty(
110
+ status=Status.ENABLED,
111
+ target_file_size_mb=128
112
+ ),
113
+ snapshot_management=SnapshotManagementProperty(
114
+ status=Status.ENABLED,
115
+ max_snapshot_age_hours=48,
116
+ min_snapshots_to_keep=5
117
+ )
118
+ )
119
+ ```
120
+
70
121
  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)
71
122
 
72
123
  ### Controlling Table Bucket Permissions
@@ -134,9 +185,36 @@ encrypted_bucket_auto = TableBucket(scope, "EncryptedTableBucketAuto",
134
185
  )
135
186
  ```
136
187
 
188
+ ### Controlling Table Permissions
189
+
190
+ ```python
191
+ # Grant the principal read permissions to the table
192
+ account_id = "123456789012"
193
+ table.grant_read(iam.AccountPrincipal(account_id))
194
+
195
+ # Grant the role write permissions to the table
196
+ role = iam.Role(stack, "MyRole", assumed_by=iam.ServicePrincipal("sample"))
197
+ table.grant_write(role)
198
+
199
+ # Grant the user read and write permissions to the table
200
+ table.grant_read_write(iam.User(stack, "MyUser"))
201
+
202
+ # Grant an account permissions to the table
203
+ table.grant_read_write(iam.AccountPrincipal(account_id))
204
+
205
+ # Add custom resource policy statements
206
+ permissions = iam.PolicyStatement(
207
+ effect=iam.Effect.ALLOW,
208
+ actions=["s3tables:*"],
209
+ principals=[iam.ServicePrincipal("example.aws.internal")],
210
+ resources=["*"]
211
+ )
212
+
213
+ table.add_to_resource_policy(permissions)
214
+ ```
215
+
137
216
  ## Coming Soon
138
217
 
139
218
  L2 Construct support for:
140
219
 
141
- * Namespaces
142
- * Tables
220
+ * KMS encryption support for Tables
@@ -0,0 +1,10 @@
1
+ aws_cdk/aws_s3tables_alpha/__init__.py,sha256=zCLVyk4ieefzu16_y0NZtf7Zx9hQ_RLI3dDkjL7_J_Q,157971
2
+ aws_cdk/aws_s3tables_alpha/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
+ aws_cdk/aws_s3tables_alpha/_jsii/__init__.py,sha256=x3GtpLkKDvtfAFKtE8NbBDfE879G4Yjvto33bkIRDJU,1489
4
+ aws_cdk/aws_s3tables_alpha/_jsii/aws-s3tables-alpha@2.223.0-alpha.0.jsii.tgz,sha256=T6q8nv3dtgeBCWng5isMazFFgFZsWlyxk82v-cinAfM,91505
5
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/LICENSE,sha256=y47tc38H0C4DpGljYUZDl8XxidQjNxxGLq-K4jwv6Xc,11391
6
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/METADATA,sha256=yvn6UsqDFGrKUYfwT0OVtG9F7u7WIn2BG7MAk9l8OAA,7238
7
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/NOTICE,sha256=ZDV6_xBfMvhFtjjBh_f6lJjhZ2AEWWAGGkx2kLKHiuc,113
8
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
9
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
10
+ aws_cdk_aws_s3tables_alpha-2.223.0a0.dist-info/RECORD,,
@@ -1,10 +0,0 @@
1
- aws_cdk/aws_s3tables_alpha/__init__.py,sha256=vwIKJGF7Et8gRl1mS7SmWoVieAyIAzQyLhXMhLbi3Pk,69799
2
- aws_cdk/aws_s3tables_alpha/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
- aws_cdk/aws_s3tables_alpha/_jsii/__init__.py,sha256=k8iJ3mDvcuNLWlZs84EzrN3dbmShdp7rJ33ouBTIhcQ,1489
4
- aws_cdk/aws_s3tables_alpha/_jsii/aws-s3tables-alpha@2.207.0-alpha.0.jsii.tgz,sha256=9zhl_KLe_RQPQzaqPmYQTJ6QprwmJVuj-oLaq_CIsRw,57276
5
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/LICENSE,sha256=y47tc38H0C4DpGljYUZDl8XxidQjNxxGLq-K4jwv6Xc,11391
6
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/METADATA,sha256=oWSeFJCzF2DqbqtF9OHWxoFIwc98BR8Dx6o0XkESBlw,5137
7
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/NOTICE,sha256=ZDV6_xBfMvhFtjjBh_f6lJjhZ2AEWWAGGkx2kLKHiuc,113
8
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
9
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
10
- aws_cdk_aws_s3tables_alpha-2.207.0a0.dist-info/RECORD,,