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.

• If you use this operation with the optional metadata request parameter you must have the s3tables:PutTableData permission.

• If you use this operation with the optional encryptionConfiguration request parameter you must have the s3tables:PutTableEncryption permission.

Additionally,

Usage

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

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.
encryptionConfiguration	The encryption configuration to use for the table. This configuration specifies the encryption algorithm and, if using SSE-KMS, the KMS key to use for encrypting the table. If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.

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
          )
        )
      )
    )
  ),
  encryptionConfiguration = list(
    sseAlgorithm = "AES256"|"aws:kms",
    kmsKeyArn = "string"
  )
)