Skip to content

/AWS1/CL_DYN=>EXPORTTABLETOPOINTINTIME()

About ExportTableToPointInTime

Exports table data to an S3 bucket. The table must have point in time recovery enabled, and you can export data from any time within the point in time recovery window.

Method Signature

IMPORTING

Required arguments:

iv_tablearn TYPE /AWS1/DYNTABLEARN /AWS1/DYNTABLEARN

The Amazon Resource Name (ARN) associated with the table to export.

iv_s3bucket TYPE /AWS1/DYNS3BUCKET /AWS1/DYNS3BUCKET

The name of the Amazon S3 bucket to export the snapshot to.

Optional arguments:

iv_exporttime TYPE /AWS1/DYNEXPORTTIME /AWS1/DYNEXPORTTIME

Time in the past from which to export table data, counted in seconds from the start of the Unix epoch. The table export will be a snapshot of the table's state at this point in time.

iv_clienttoken TYPE /AWS1/DYNCLIENTTOKEN /AWS1/DYNCLIENTTOKEN

Providing a ClientToken makes the call to ExportTableToPointInTimeInput idempotent, meaning that multiple identical calls have the same effect as one single call.

A client token is valid for 8 hours after the first request that uses it is completed. After 8 hours, any request with the same client token is treated as a new request. Do not resubmit the same request with the same client token for more than 8 hours, or the result might not be idempotent.

If you submit a request with the same client token but a change in other parameters within the 8-hour idempotency window, DynamoDB returns an ImportConflictException.

iv_s3bucketowner TYPE /AWS1/DYNS3BUCKETOWNER /AWS1/DYNS3BUCKETOWNER

The ID of the Amazon Web Services account that owns the bucket the export will be stored in.

S3BucketOwner is a required parameter when exporting to a S3 bucket in another account.

iv_s3prefix TYPE /AWS1/DYNS3PREFIX /AWS1/DYNS3PREFIX

The Amazon S3 bucket prefix to use as the file name and path of the exported snapshot.

iv_s3ssealgorithm TYPE /AWS1/DYNS3SSEALGORITHM /AWS1/DYNS3SSEALGORITHM

Type of encryption used on the bucket where export data will be stored. Valid values for S3SseAlgorithm are:

  • AES256 - server-side encryption with Amazon S3 managed keys

  • KMS - server-side encryption with KMS managed keys

iv_s3ssekmskeyid TYPE /AWS1/DYNS3SSEKMSKEYID /AWS1/DYNS3SSEKMSKEYID

The ID of the KMS managed key used to encrypt the S3 bucket where export data will be stored (if applicable).

iv_exportformat TYPE /AWS1/DYNEXPORTFORMAT /AWS1/DYNEXPORTFORMAT

The format for the exported data. Valid values for ExportFormat are DYNAMODB_JSON or ION.

iv_exporttype TYPE /AWS1/DYNEXPORTTYPE /AWS1/DYNEXPORTTYPE

Choice of whether to execute as a full export or incremental export. Valid values are FULL_EXPORT or INCREMENTAL_EXPORT. The default value is FULL_EXPORT. If INCREMENTAL_EXPORT is provided, the IncrementalExportSpecification must also be used.

io_incrementalexportspec TYPE REF TO /AWS1/CL_DYNINCREMENTALEXPPEC /AWS1/CL_DYNINCREMENTALEXPPEC

Optional object containing the parameters specific to an incremental export.

RETURNING

oo_output TYPE REF TO /aws1/cl_dynexptbltoptintmout /AWS1/CL_DYNEXPTBLTOPTINTMOUT

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_dyn~exporttabletopointintime(
  io_incrementalexportspec = new /aws1/cl_dynincrementalexppec(
    iv_exportfromtime = '20150101000000.0000000'
    iv_exporttotime = '20150101000000.0000000'
    iv_exportviewtype = |string|
  )
  iv_clienttoken = |string|
  iv_exportformat = |string|
  iv_exporttime = '20150101000000.0000000'
  iv_exporttype = |string|
  iv_s3bucket = |string|
  iv_s3bucketowner = |string|
  iv_s3prefix = |string|
  iv_s3ssealgorithm = |string|
  iv_s3ssekmskeyid = |string|
  iv_tablearn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_exportdescription = lo_result->get_exportdescription( ).
  IF lo_exportdescription IS NOT INITIAL.
    lv_exportarn = lo_exportdescription->get_exportarn( ).
    lv_exportstatus = lo_exportdescription->get_exportstatus( ).
    lv_exportstarttime = lo_exportdescription->get_starttime( ).
    lv_exportendtime = lo_exportdescription->get_endtime( ).
    lv_exportmanifest = lo_exportdescription->get_exportmanifest( ).
    lv_tablearn = lo_exportdescription->get_tablearn( ).
    lv_tableid = lo_exportdescription->get_tableid( ).
    lv_exporttime = lo_exportdescription->get_exporttime( ).
    lv_clienttoken = lo_exportdescription->get_clienttoken( ).
    lv_s3bucket = lo_exportdescription->get_s3bucket( ).
    lv_s3bucketowner = lo_exportdescription->get_s3bucketowner( ).
    lv_s3prefix = lo_exportdescription->get_s3prefix( ).
    lv_s3ssealgorithm = lo_exportdescription->get_s3ssealgorithm( ).
    lv_s3ssekmskeyid = lo_exportdescription->get_s3ssekmskeyid( ).
    lv_failurecode = lo_exportdescription->get_failurecode( ).
    lv_failuremessage = lo_exportdescription->get_failuremessage( ).
    lv_exportformat = lo_exportdescription->get_exportformat( ).
    lv_billedsizebytes = lo_exportdescription->get_billedsizebytes( ).
    lv_itemcount = lo_exportdescription->get_itemcount( ).
    lv_exporttype = lo_exportdescription->get_exporttype( ).
    lo_incrementalexportspecif = lo_exportdescription->get_incrementalexportspec( ).
    IF lo_incrementalexportspecif IS NOT INITIAL.
      lv_exportfromtime = lo_incrementalexportspecif->get_exportfromtime( ).
      lv_exporttotime = lo_incrementalexportspecif->get_exporttotime( ).
      lv_exportviewtype = lo_incrementalexportspecif->get_exportviewtype( ).
    ENDIF.
  ENDIF.
ENDIF.