Create Table

s3tables_create_table

R Documentation

Creates a new table associated with the given namespace in a table bucket

Description

Creates a new table associated with the given namespace in a table bucket. For more information, see Creating an Amazon S3 table in the Amazon Simple Storage Service User Guide.

Permissions

You must have the s3tables:CreateTable permission to use this operation.

Additionally, you must have the s3tables:PutTableData permission to use this operation with the optional metadata request parameter.

Usage

s3tables_create_table(tableBucketARN, namespace, name, format, metadata)

Arguments

tableBucketARN	[required] The Amazon Resource Name (ARN) of the table bucket to create the table in.
namespace	[required] The namespace to associated with the table.
name	[required] The name for the table.
format	[required] The format for the table.
metadata	The metadata for the table.

Value

A list with the following syntax:

list(
  tableARN = "string",
  versionToken = "string"
)

Request syntax

svc$create_table(
  tableBucketARN = "string",
  namespace = "string",
  name = "string",
  format = "ICEBERG",
  metadata = list(
    iceberg = list(
      schema = list(
        fields = list(
          list(
            name = "string",
            type = "string",
            required = TRUE|FALSE
          )
        )
      )
    )
  )
)