awswrangler.s3.create_table

awswrangler.s3.create_table(table_bucket_arn: str, namespace: str, table_name: str, format: str = 'ICEBERG', boto3_session: Session | None = None) → str

Create a table in an S3 Table Bucket namespace.

Parameters:

  • table_bucket_arn (str) – The ARN of the table bucket.

  • namespace (str) – The namespace in which to create the table.

  • table_name (str) – The name of the table to create.

  • format (str, optional) – The table format. Default is "ICEBERG".

  • boto3_session (boto3.Session, optional) – Boto3 Session. If None, the default boto3 session is used.

Returns:

The ARN of the created table.

Return type:

str

Examples

>>> import awswrangler as wr
>>> table_arn = wr.s3.create_table(
...     table_bucket_arn="arn:aws:s3tables:us-east-1:123456789012:bucket/my-bucket",
...     namespace="my_namespace",
...     table_name="my_table",
... )