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
          )
        )
      )
    )
  )
)