/AWS1/IF_DYN=>TRANSACTGETITEMS()¶
About TransactGetItems¶
TransactGetItems is a synchronous operation that atomically retrieves
multiple items from one or more tables (but not from indexes) in a single account and
Region. A TransactGetItems call can contain up to 100
TransactGetItem objects, each of which contains a Get
structure that specifies an item to retrieve from a table in the account and Region. A
call to TransactGetItems cannot retrieve items from tables in more than one
Amazon Web Services account or Region. The aggregate size of the items in the
transaction cannot exceed 4 MB.
DynamoDB rejects the entire TransactGetItems request if any of
the following is true:
-
A conflicting operation is in the process of updating an item to be read.
-
There is insufficient provisioned capacity for the transaction to be completed.
-
There is a user error, such as an invalid data format.
-
The aggregate size of the items in the transaction exceeded 4 MB.
Method Signature¶
METHODS /AWS1/IF_DYN~TRANSACTGETITEMS
IMPORTING
!IT_TRANSACTITEMS TYPE /AWS1/CL_DYNTRANSACTGETITEM=>TT_TRANSACTGETITEMLIST OPTIONAL
!IV_RETURNCONSUMEDCAPACITY TYPE /AWS1/DYNRETURNCONSUMEDCAP OPTIONAL
RETURNING
VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dyntransactgetitems01
RAISING
/AWS1/CX_DYNINTERNALSERVERERR
/AWS1/CX_DYNINVALIDENDPOINTEX
/AWS1/CX_DYNPROVTHRUPUTEXCDEX
/AWS1/CX_DYNREQUESTLIMITEXCD
/AWS1/CX_DYNRESOURCENOTFOUNDEX
/AWS1/CX_DYNTHROTTLINGEX
/AWS1/CX_DYNTRANSACTCANCEDEX
/AWS1/CX_DYNCLIENTEXC
/AWS1/CX_DYNSERVEREXC
/AWS1/CX_RT_TECHNICAL_GENERIC
/AWS1/CX_RT_SERVICE_GENERIC.
IMPORTING¶
Required arguments:¶
it_transactitems TYPE /AWS1/CL_DYNTRANSACTGETITEM=>TT_TRANSACTGETITEMLIST TT_TRANSACTGETITEMLIST¶
An ordered array of up to 100
TransactGetItemobjects, each of which contains aGetstructure.
Optional arguments:¶
iv_returnconsumedcapacity TYPE /AWS1/DYNRETURNCONSUMEDCAP /AWS1/DYNRETURNCONSUMEDCAP¶
A value of
TOTALcauses consumed capacity information to be returned, and a value ofNONEprevents that information from being returned. No other value is valid.
RETURNING¶
oo_output TYPE REF TO /aws1/cl_dyntransactgetitems01 /AWS1/CL_DYNTRANSACTGETITEMS01¶
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->transactgetitems(
it_transactitems = VALUE /aws1/cl_dyntransactgetitem=>tt_transactgetitemlist(
(
new /aws1/cl_dyntransactgetitem(
io_get = new /aws1/cl_dynget(
it_expressionattributenames = VALUE /aws1/cl_dynxprsnattrnamemap_w=>tt_expressionattributenamemap(
(
VALUE /aws1/cl_dynxprsnattrnamemap_w=>ts_xprsnattrnamemap_maprow(
value = new /aws1/cl_dynxprsnattrnamemap_w( |string| )
key = |string|
)
)
)
it_key = VALUE /aws1/cl_dynattributevalue=>tt_key(
(
VALUE /aws1/cl_dynattributevalue=>ts_key_maprow(
value = new /aws1/cl_dynattributevalue(
it_bs = VALUE /aws1/cl_dynbinarysetattrval_w=>tt_binarysetattributevalue(
( new /aws1/cl_dynbinarysetattrval_w( '5347567362473873563239796247513D' ) )
)
it_l = VALUE /aws1/cl_dynattributevalue=>tt_listattributevalue(
(
new /aws1/cl_dynattributevalue(
it_bs = VALUE /aws1/cl_dynbinarysetattrval_w=>tt_binarysetattributevalue(
( new /aws1/cl_dynbinarysetattrval_w( '5347567362473873563239796247513D' ) )
)
it_m = VALUE /aws1/cl_dynattributevalue=>tt_mapattributevalue(
(
VALUE /aws1/cl_dynattributevalue=>ts_mapattributevalue_maprow(
value = new /aws1/cl_dynattributevalue(
it_bs = VALUE /aws1/cl_dynbinarysetattrval_w=>tt_binarysetattributevalue(
( new /aws1/cl_dynbinarysetattrval_w( '5347567362473873563239796247513D' ) )
)
it_ns = VALUE /aws1/cl_dynnumsetattrvalue_w=>tt_numbersetattributevalue(
( new /aws1/cl_dynnumsetattrvalue_w( |string| ) )
)
it_ss = VALUE /aws1/cl_dynstrsetattrvalue_w=>tt_stringsetattributevalue(
( new /aws1/cl_dynstrsetattrvalue_w( |string| ) )
)
iv_b = '5347567362473873563239796247513D'
iv_bool = ABAP_TRUE
iv_n = |string|
iv_null = ABAP_TRUE
iv_s = |string|
)
key = |string|
)
)
)
it_ns = VALUE /aws1/cl_dynnumsetattrvalue_w=>tt_numbersetattributevalue(
( new /aws1/cl_dynnumsetattrvalue_w( |string| ) )
)
it_ss = VALUE /aws1/cl_dynstrsetattrvalue_w=>tt_stringsetattributevalue(
( new /aws1/cl_dynstrsetattrvalue_w( |string| ) )
)
iv_b = '5347567362473873563239796247513D'
iv_bool = ABAP_TRUE
iv_n = |string|
iv_null = ABAP_TRUE
iv_s = |string|
)
)
)
it_m = VALUE /aws1/cl_dynattributevalue=>tt_mapattributevalue(
(
VALUE /aws1/cl_dynattributevalue=>ts_mapattributevalue_maprow(
value = new /aws1/cl_dynattributevalue(
it_bs = VALUE /aws1/cl_dynbinarysetattrval_w=>tt_binarysetattributevalue(
( new /aws1/cl_dynbinarysetattrval_w( '5347567362473873563239796247513D' ) )
)
it_l = VALUE /aws1/cl_dynattributevalue=>tt_listattributevalue(
(
new /aws1/cl_dynattributevalue(
it_bs = VALUE /aws1/cl_dynbinarysetattrval_w=>tt_binarysetattributevalue(
( new /aws1/cl_dynbinarysetattrval_w( '5347567362473873563239796247513D' ) )
)
it_ns = VALUE /aws1/cl_dynnumsetattrvalue_w=>tt_numbersetattributevalue(
( new /aws1/cl_dynnumsetattrvalue_w( |string| ) )
)
it_ss = VALUE /aws1/cl_dynstrsetattrvalue_w=>tt_stringsetattributevalue(
( new /aws1/cl_dynstrsetattrvalue_w( |string| ) )
)
iv_b = '5347567362473873563239796247513D'
iv_bool = ABAP_TRUE
iv_n = |string|
iv_null = ABAP_TRUE
iv_s = |string|
)
)
)
it_ns = VALUE /aws1/cl_dynnumsetattrvalue_w=>tt_numbersetattributevalue(
( new /aws1/cl_dynnumsetattrvalue_w( |string| ) )
)
it_ss = VALUE /aws1/cl_dynstrsetattrvalue_w=>tt_stringsetattributevalue(
( new /aws1/cl_dynstrsetattrvalue_w( |string| ) )
)
iv_b = '5347567362473873563239796247513D'
iv_bool = ABAP_TRUE
iv_n = |string|
iv_null = ABAP_TRUE
iv_s = |string|
)
key = |string|
)
)
)
it_ns = VALUE /aws1/cl_dynnumsetattrvalue_w=>tt_numbersetattributevalue(
( new /aws1/cl_dynnumsetattrvalue_w( |string| ) )
)
it_ss = VALUE /aws1/cl_dynstrsetattrvalue_w=>tt_stringsetattributevalue(
( new /aws1/cl_dynstrsetattrvalue_w( |string| ) )
)
iv_b = '5347567362473873563239796247513D'
iv_bool = ABAP_TRUE
iv_n = |string|
iv_null = ABAP_TRUE
iv_s = |string|
)
key = |string|
)
)
)
iv_projectionexpression = |string|
iv_tablename = |string|
)
)
)
)
iv_returnconsumedcapacity = |string|
).
This is an example of reading all possible response values
lo_result = lo_result.
IF lo_result IS NOT INITIAL.
LOOP AT lo_result->get_consumedcapacity( ) into lo_row.
lo_row_1 = lo_row.
IF lo_row_1 IS NOT INITIAL.
lv_tablearn = lo_row_1->get_tablename( ).
lv_consumedcapacityunits = lo_row_1->get_capacityunits( ).
lv_consumedcapacityunits = lo_row_1->get_readcapacityunits( ).
lv_consumedcapacityunits = lo_row_1->get_writecapacityunits( ).
lo_capacity = lo_row_1->get_table( ).
IF lo_capacity IS NOT INITIAL.
lv_consumedcapacityunits = lo_capacity->get_readcapacityunits( ).
lv_consumedcapacityunits = lo_capacity->get_writecapacityunits( ).
lv_consumedcapacityunits = lo_capacity->get_capacityunits( ).
ENDIF.
LOOP AT lo_row_1->get_localsecondaryindexes( ) into ls_row_2.
lv_key = ls_row_2-key.
lo_value = ls_row_2-value.
IF lo_value IS NOT INITIAL.
lv_consumedcapacityunits = lo_value->get_readcapacityunits( ).
lv_consumedcapacityunits = lo_value->get_writecapacityunits( ).
lv_consumedcapacityunits = lo_value->get_capacityunits( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_1->get_globalsecondaryindexes( ) into ls_row_2.
lv_key = ls_row_2-key.
lo_value = ls_row_2-value.
IF lo_value IS NOT INITIAL.
lv_consumedcapacityunits = lo_value->get_readcapacityunits( ).
lv_consumedcapacityunits = lo_value->get_writecapacityunits( ).
lv_consumedcapacityunits = lo_value->get_capacityunits( ).
ENDIF.
ENDLOOP.
ENDIF.
ENDLOOP.
LOOP AT lo_result->get_responses( ) into lo_row_3.
lo_row_4 = lo_row_3.
IF lo_row_4 IS NOT INITIAL.
LOOP AT lo_row_4->get_item( ) into ls_row_5.
lv_key_1 = ls_row_5-key.
lo_value_1 = ls_row_5-value.
IF lo_value_1 IS NOT INITIAL.
lv_stringattributevalue = lo_value_1->get_s( ).
lv_numberattributevalue = lo_value_1->get_n( ).
lv_binaryattributevalue = lo_value_1->get_b( ).
LOOP AT lo_value_1->get_ss( ) into lo_row_6.
lo_row_7 = lo_row_6.
IF lo_row_7 IS NOT INITIAL.
lv_stringattributevalue = lo_row_7->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_1->get_ns( ) into lo_row_8.
lo_row_9 = lo_row_8.
IF lo_row_9 IS NOT INITIAL.
lv_numberattributevalue = lo_row_9->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_1->get_bs( ) into lo_row_10.
lo_row_11 = lo_row_10.
IF lo_row_11 IS NOT INITIAL.
lv_binaryattributevalue = lo_row_11->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_1->get_m( ) into ls_row_12.
lv_key_1 = ls_row_12-key.
lo_value_2 = ls_row_12-value.
IF lo_value_2 IS NOT INITIAL.
lv_stringattributevalue = lo_value_2->get_s( ).
lv_numberattributevalue = lo_value_2->get_n( ).
lv_binaryattributevalue = lo_value_2->get_b( ).
LOOP AT lo_value_2->get_ss( ) into lo_row_6.
lo_row_7 = lo_row_6.
IF lo_row_7 IS NOT INITIAL.
lv_stringattributevalue = lo_row_7->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_2->get_ns( ) into lo_row_8.
lo_row_9 = lo_row_8.
IF lo_row_9 IS NOT INITIAL.
lv_numberattributevalue = lo_row_9->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_2->get_bs( ) into lo_row_10.
lo_row_11 = lo_row_10.
IF lo_row_11 IS NOT INITIAL.
lv_binaryattributevalue = lo_row_11->get_value( ).
ENDIF.
ENDLOOP.
" Skipping ls_row_12-value to avoid recursion
LOOP AT lo_value_2->get_l( ) into lo_row_13.
lo_row_14 = lo_row_13.
IF lo_row_14 IS NOT INITIAL.
lv_stringattributevalue = lo_row_14->get_s( ).
lv_numberattributevalue = lo_row_14->get_n( ).
lv_binaryattributevalue = lo_row_14->get_b( ).
LOOP AT lo_row_14->get_ss( ) into lo_row_6.
lo_row_7 = lo_row_6.
IF lo_row_7 IS NOT INITIAL.
lv_stringattributevalue = lo_row_7->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_14->get_ns( ) into lo_row_8.
lo_row_9 = lo_row_8.
IF lo_row_9 IS NOT INITIAL.
lv_numberattributevalue = lo_row_9->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_14->get_bs( ) into lo_row_10.
lo_row_11 = lo_row_10.
IF lo_row_11 IS NOT INITIAL.
lv_binaryattributevalue = lo_row_11->get_value( ).
ENDIF.
ENDLOOP.
" Skipping lo_row_13 to avoid recursion
" Skipping lo_row_13 to avoid recursion
lv_nullattributevalue = lo_row_14->get_null( ).
lv_booleanattributevalue = lo_row_14->get_bool( ).
ENDIF.
ENDLOOP.
lv_nullattributevalue = lo_value_2->get_null( ).
lv_booleanattributevalue = lo_value_2->get_bool( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_1->get_l( ) into lo_row_13.
lo_row_14 = lo_row_13.
IF lo_row_14 IS NOT INITIAL.
lv_stringattributevalue = lo_row_14->get_s( ).
lv_numberattributevalue = lo_row_14->get_n( ).
lv_binaryattributevalue = lo_row_14->get_b( ).
LOOP AT lo_row_14->get_ss( ) into lo_row_6.
lo_row_7 = lo_row_6.
IF lo_row_7 IS NOT INITIAL.
lv_stringattributevalue = lo_row_7->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_14->get_ns( ) into lo_row_8.
lo_row_9 = lo_row_8.
IF lo_row_9 IS NOT INITIAL.
lv_numberattributevalue = lo_row_9->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_14->get_bs( ) into lo_row_10.
lo_row_11 = lo_row_10.
IF lo_row_11 IS NOT INITIAL.
lv_binaryattributevalue = lo_row_11->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_row_14->get_m( ) into ls_row_12.
lv_key_1 = ls_row_12-key.
lo_value_2 = ls_row_12-value.
IF lo_value_2 IS NOT INITIAL.
lv_stringattributevalue = lo_value_2->get_s( ).
lv_numberattributevalue = lo_value_2->get_n( ).
lv_binaryattributevalue = lo_value_2->get_b( ).
LOOP AT lo_value_2->get_ss( ) into lo_row_6.
lo_row_7 = lo_row_6.
IF lo_row_7 IS NOT INITIAL.
lv_stringattributevalue = lo_row_7->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_2->get_ns( ) into lo_row_8.
lo_row_9 = lo_row_8.
IF lo_row_9 IS NOT INITIAL.
lv_numberattributevalue = lo_row_9->get_value( ).
ENDIF.
ENDLOOP.
LOOP AT lo_value_2->get_bs( ) into lo_row_10.
lo_row_11 = lo_row_10.
IF lo_row_11 IS NOT INITIAL.
lv_binaryattributevalue = lo_row_11->get_value( ).
ENDIF.
ENDLOOP.
" Skipping ls_row_12-value to avoid recursion
" Skipping ls_row_12-value to avoid recursion
lv_nullattributevalue = lo_value_2->get_null( ).
lv_booleanattributevalue = lo_value_2->get_bool( ).
ENDIF.
ENDLOOP.
" Skipping lo_row_13 to avoid recursion
lv_nullattributevalue = lo_row_14->get_null( ).
lv_booleanattributevalue = lo_row_14->get_bool( ).
ENDIF.
ENDLOOP.
lv_nullattributevalue = lo_value_1->get_null( ).
lv_booleanattributevalue = lo_value_1->get_bool( ).
ENDIF.
ENDLOOP.
ENDIF.
ENDLOOP.
ENDIF.