Skip to content

/AWS1/IF_TSW=>CREATEBATCHLOADTASK()

About CreateBatchLoadTask

Creates a new Timestream batch load task. A batch load task processes data from a CSV source in an S3 location and writes to a Timestream table. A mapping from source to target is defined in a batch load task. Errors and events are written to a report at an S3 location. For the report, if the KMS key is not specified, the report will be encrypted with an S3 managed key when SSE_S3 is the option. Otherwise an error is thrown. For more information, see Amazon Web Services managed keys. Service quotas apply. For details, see code sample.

Method Signature

IMPORTING

Required arguments:

io_datasourceconfiguration TYPE REF TO /AWS1/CL_TSWDATASOURCECONF /AWS1/CL_TSWDATASOURCECONF

Defines configuration details about the data source for a batch load task.

io_reportconfiguration TYPE REF TO /AWS1/CL_TSWREPORTCONF /AWS1/CL_TSWREPORTCONF

ReportConfiguration

iv_targetdatabasename TYPE /AWS1/TSWRESOURCECREATEAPINAME /AWS1/TSWRESOURCECREATEAPINAME

Target Timestream database for a batch load task.

iv_targettablename TYPE /AWS1/TSWRESOURCECREATEAPINAME /AWS1/TSWRESOURCECREATEAPINAME

Target Timestream table for a batch load task.

Optional arguments:

iv_clienttoken TYPE /AWS1/TSWCLIENTREQUESTTOKEN /AWS1/TSWCLIENTREQUESTTOKEN

io_datamodelconfiguration TYPE REF TO /AWS1/CL_TSWDATAMODELCONF /AWS1/CL_TSWDATAMODELCONF

DataModelConfiguration

iv_recordversion TYPE /AWS1/TSWRECORDVERSION /AWS1/TSWRECORDVERSION

RETURNING

oo_output TYPE REF TO /aws1/cl_tswcrebtcloadtaskrsp /AWS1/CL_TSWCREBTCLOADTASKRSP

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_tsw~createbatchloadtask(
  io_datamodelconfiguration = new /aws1/cl_tswdatamodelconf(
    io_datamodel = new /aws1/cl_tswdatamodel(
      io_multimeasuremappings = new /aws1/cl_tswmultimeasuremaps(
        it_multimeasureattrmappings = VALUE /aws1/cl_tswmultimeasureattr00=>tt_multimeasureattrmappinglist(
          (
            new /aws1/cl_tswmultimeasureattr00(
              iv_measurevaluetype = |string|
              iv_sourcecolumn = |string|
              iv_tgtmultimeasureattrname = |string|
            )
          )
        )
        iv_targetmultimeasurename = |string|
      )
      it_dimensionmappings = VALUE /aws1/cl_tswdimensionmapping=>tt_dimensionmappings(
        (
          new /aws1/cl_tswdimensionmapping(
            iv_destinationcolumn = |string|
            iv_sourcecolumn = |string|
          )
        )
      )
      it_mixedmeasuremappings = VALUE /aws1/cl_tswmixedmeasuremap=>tt_mixedmeasuremappinglist(
        (
          new /aws1/cl_tswmixedmeasuremap(
            it_multimeasureattrmappings = VALUE /aws1/cl_tswmultimeasureattr00=>tt_multimeasureattrmappinglist(
              (
                new /aws1/cl_tswmultimeasureattr00(
                  iv_measurevaluetype = |string|
                  iv_sourcecolumn = |string|
                  iv_tgtmultimeasureattrname = |string|
                )
              )
            )
            iv_measurename = |string|
            iv_measurevaluetype = |string|
            iv_sourcecolumn = |string|
            iv_targetmeasurename = |string|
          )
        )
      )
      iv_measurenamecolumn = |string|
      iv_timecolumn = |string|
      iv_timeunit = |string|
    )
    io_datamodels3configuration = new /aws1/cl_tswdatamodels3conf(
      iv_bucketname = |string|
      iv_objectkey = |string|
    )
  )
  io_datasourceconfiguration = new /aws1/cl_tswdatasourceconf(
    io_csvconfiguration = new /aws1/cl_tswcsvconfiguration(
      iv_columnseparator = |string|
      iv_escapechar = |string|
      iv_nullvalue = |string|
      iv_quotechar = |string|
      iv_trimwhitespace = ABAP_TRUE
    )
    io_datasources3configuration = new /aws1/cl_tswdatasources3conf(
      iv_bucketname = |string|
      iv_objectkeyprefix = |string|
    )
    iv_dataformat = |string|
  )
  io_reportconfiguration = new /aws1/cl_tswreportconf(
    io_reports3configuration = new /aws1/cl_tswreports3conf(
      iv_bucketname = |string|
      iv_encryptionoption = |string|
      iv_kmskeyid = |string|
      iv_objectkeyprefix = |string|
    )
  )
  iv_clienttoken = |string|
  iv_recordversion = 123
  iv_targetdatabasename = |string|
  iv_targettablename = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_batchloadtaskid = lo_result->get_taskid( ).
ENDIF.