Creating a table bucket - Amazon Simple Storage Service

Creating a table bucket

Amazon S3 table buckets are an S3 bucket type that you can use to create and store tables as S3 resources. To start using S3 Tables, you create a table bucket where you store and manage tables. When you create a table bucket, you choose a bucket name and AWS Region, the name must be unique for your account in the chosen Region. After you create a table bucket, you cannot change the bucket name or Region. For information about naming table buckets, see Amazon S3 table bucket, table, and namespace naming rules.

Table buckets have the following Amazon Resource Name (ARN) format:

arn:aws:s3tables:Region:OwnerAccountID:bucket/bucket-name

By default, you can create up to 10 table buckets per Region in an AWS account. To request a quota increase for Table buckets or tables, contact AWS Support.

To create a table bucket, you can use the Amazon S3 console, Amazon S3 APIs, AWS Command Line Interface, or AWS SDKs.

  1. Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.

  2. In the navigation bar on the top of the page, choose the name of the currently displayed AWS Region. Next, choose the Region in which you want to create a bucket.

  3. In the left navigation pane, choose Table buckets.

  4. Choose Create table bucket to open the Create table bucket page.

  5. Under Properties, enter a name for your table bucket.

    The table bucket name must:

    • Be unique within for your account in the current Region.

    • Be between 3 and 63 characters long

    • Consist only of lowercase letters, numbers, and hyphens (-).

    • Begin and end with a letter or number.

    After you create the bucket, you can't change its name. The AWS account that creates the bucket owns it. For information about naming table buckets, see Amazon S3 table bucket, table, and namespace naming rules.

  6. Choose Create bucket. If you want to integrate your table buckets with AWS analytics services, make sure Enable integration is selected.

Note

When you create you first table bucket using the console with the Enable integration option, Amazon S3 attempts to automatically integrate your table bucket with AWS analytics services. This integration allows you to use AWS analytics services to query all tables in the current Region. For more information see, Using Amazon S3 Tables with AWS analytics services.

This example shows how to create a table bucket by using the AWS CLI. To use this example, replace the user input placeholders with your own information.

aws s3tables create-table-bucket \
    --region us-east-2 \
    --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1