Skip to content

/AWS1/CL_S3T=>CREATETABLE()

About CreateTable

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, 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.

Method Signature

IMPORTING

Required arguments:

iv_tablebucketarn TYPE /AWS1/S3TTABLEBUCKETARN /AWS1/S3TTABLEBUCKETARN

The Amazon Resource Name (ARN) of the table bucket to create the table in.

iv_namespace TYPE /AWS1/S3TNAMESPACENAME /AWS1/S3TNAMESPACENAME

The namespace to associated with the table.

iv_name TYPE /AWS1/S3TTABLENAME /AWS1/S3TTABLENAME

The name for the table.

iv_format TYPE /AWS1/S3TOPENTABLEFORMAT /AWS1/S3TOPENTABLEFORMAT

The format for the table.

Optional arguments:

io_metadata TYPE REF TO /AWS1/CL_S3TTABLEMETADATA /AWS1/CL_S3TTABLEMETADATA

The metadata for the table.

io_encryptionconfiguration TYPE REF TO /AWS1/CL_S3TENCRYPTIONCONF /AWS1/CL_S3TENCRYPTIONCONF

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.

RETURNING

oo_output TYPE REF TO /aws1/cl_s3tcreatetablersp /AWS1/CL_S3TCREATETABLERSP

Domain /AWS1/RT_ACCOUNT_ID
Primitive Type NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->/aws1/if_s3t~createtable(
  io_encryptionconfiguration = new /aws1/cl_s3tencryptionconf(
    iv_kmskeyarn = |string|
    iv_ssealgorithm = |string|
  )
  io_metadata = new /aws1/cl_s3ttablemetadata(
    io_iceberg = new /aws1/cl_s3ticebergmetadata(
      io_schema = new /aws1/cl_s3ticebergschema(
        it_fields = VALUE /aws1/cl_s3tschemafield=>tt_schemafieldlist(
          (
            new /aws1/cl_s3tschemafield(
              iv_name = |string|
              iv_required = ABAP_TRUE
              iv_type = |string|
            )
          )
        )
      )
    )
  )
  iv_format = |string|
  iv_name = |string|
  iv_namespace = |string|
  iv_tablebucketarn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_tablearn = lo_result->get_tablearn( ).
  lv_versiontoken = lo_result->get_versiontoken( ).
ENDIF.