Skip to content

/AWS1/IF_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.

  • You must have the s3tables:TagResource permission in addition to s3tables:CreateTable permission to create a table with tags.

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

METHODS /AWS1/IF_S3T~CREATETABLE
  IMPORTING
    !IV_TABLEBUCKETARN TYPE /AWS1/S3TTABLEBUCKETARN OPTIONAL
    !IV_NAMESPACE TYPE /AWS1/S3TNAMESPACENAME OPTIONAL
    !IV_NAME TYPE /AWS1/S3TTABLENAME OPTIONAL
    !IV_FORMAT TYPE /AWS1/S3TOPENTABLEFORMAT OPTIONAL
    !IO_METADATA TYPE REF TO /AWS1/CL_S3TTABLEMETADATA OPTIONAL
    !IO_ENCRYPTIONCONFIGURATION TYPE REF TO /AWS1/CL_S3TENCRYPTIONCONF OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_S3TTAGS_W=>TT_TAGS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_s3tcreatetablersp
  RAISING
    /AWS1/CX_S3TBADREQUESTEX
    /AWS1/CX_S3TCONFLICTEXCEPTION
    /AWS1/CX_S3TFORBIDDENEXCEPTION
    /AWS1/CX_S3TINTERNALSERVERER00
    /AWS1/CX_S3TNOTFOUNDEXCEPTION
    /AWS1/CX_S3TTOOMANYREQUESTSEX
    /AWS1/CX_S3TCLIENTEXC
    /AWS1/CX_S3TSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

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.

it_tags TYPE /AWS1/CL_S3TTAGS_W=>TT_TAGS TT_TAGS

A map of user-defined tags that you would like to apply to the table that you are creating. A tag is a key-value pair that you apply to your resources. Tags can help you organize, track costs for, and control access to resources. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).

You must have the s3tables:TagResource permission in addition to s3tables:CreateTable permission to create a table with tags.

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->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|
            )
          )
        )
      )
    )
  )
  it_tags = VALUE /aws1/cl_s3ttags_w=>tt_tags(
    (
      VALUE /aws1/cl_s3ttags_w=>ts_tags_maprow(
        value = new /aws1/cl_s3ttags_w( |string| )
        key = |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.