X4 Produktdokumentation

Operation: BatchPutMultipleItems:

With the BatchPutMultipleItemsoperation of the Amazon S3 DynamoDB Connector, you insert multiple elements into a table with a single call.

For more information on other operations of the Amazon S3 DynamoDB Connector, see Amazon S3 DynamoDB Connector.

Parameters

keyID

Access key ID for requests to Amazon Web Services (AWS)

Note:

The credentials are sent to the adapter via parameters. There are various configuration options. For more information, see Setting Up Credentials.

Possible values:

Any string with the access key ID, e.g. AKIAIOSFODNN7EXAMPLE

secretKey

Secret access key for requests to AWS

Note:

The credentials are sent to the adapter via parameters. There are various configuration options. For more information, see Setting Up Credentials.

Possible values:

Any string with the secret access key, e.g. wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

region

Region of the domains

Note:

Buckets created in a specific region cannot be invoked from another region. For more information, see Regions and Endpoints.

Possible values:

Any string with the name of the region, e.g. us-east-2

tableName

✳️

This parameter is required for this operation.

Table name

Possible values:

String with the table name according to the following name rules:

  • All names must be UTF-8 encoded

  • Table names are case-sensitive

  • Table names and index names must be between 3 and 255 characters long and must contain only the following characters:

    • a-z

    • A-Z

    • 0-9

    • _ (Underscore)

    • - (Hyphen)

    • . (period)

  • Attribute names must be between 1 and 255 characters long.

partitionKey, partitionType, and partitionKeyValue

Elements of the primary table key

Possible values:

  • PartitionKey: Name of the partition key

  • PartitionType: Partition type

    • S: The attribute is a string

    • N: The attribute is a number

    • B: The attribute is of the Binary type

  • PartitionKeyValue: Value of the element

sortKey, sortType, and sortKeyValue

Elements of the primary table key

Possible values:

  • SortKey: Name of the sort key

  • SortType: Sort type

    • S: The attribute is a string

    • N: The attribute is a number

    • B: The attribute is of the Binary type

  • SortKeyValue: Value of the element

consistentRead

DynamoDB uses eventually consistent reads unless otherwise specified. Read operations such as GetItem and Query provide a ConsistentRead parameter. If this parameter is set to true, DynamoDB uses strongly consistent reads during operation.

Status values

1

The adapter operation was executed successfully

0

The operation was not completed, but no error occurred.

-1

The operation failed due to a technical error.

Input

The adapter expects a predefined XML structure as input.

Note:

You can specify multiple items. In the items, you can specify attributes of the following types: Boolean (BOOL), String (S), Number (N), Map (MAP), List (LIST), and Binary (B). The output of this operation is the same XML file. This can be useful for further operations.

<?xml version="1.0" encoding="UTF-8" ?>
<RootElement>
	<Item>
		<Attribute name="ID" type="N" value="5" />
		<Attribute name="Name" type="S" value="Luis" />
		<Attribute name="Phone" type="N" value="0034666777888" />
		<Attribute name="Bonus" type="BOOL" value="true" />
		<Attribute name="Colours" type="LIST">
			<Attribute type="S" value="Red" />
			<Attribute type="S" value="Green" />
			<Attribute type="S" value="Blue" />
			<Attribute name="Cars" type="MAP">
				<Attribute5 name="Phone" type="N" value="637559681" />
				<Attribute6 name="Bonus" type="BOOL" value="true" />
				<Attribute7 name="Profession" type="S" value="Programmer" />
				<Attribute7 name="DocumentCode" type="B" value="qwrqfgdas1223455sdfffr" />
			</Attribute>
		</Attribute>
		<Attribute name="Cars" type="MAP">
			<Attribute5 name="Phone" type="N" value="637559681" />
			<Attribute6 name="Bonus" type="BOOL" value="true" />
			<Attribute7 name="Profession" type="S" value="Programmer" />
			<Attribute7 name="DocumentCode" type="B" value="qwrqfgdas1223455sdfffr" />
		</Attribute>
	</Item>
	<Item>
		<Attribute1 name="ID" type="N" value="5" />
		<Attribute3 name="Name" type="S" value="Luis" />
		<Attribute4 name="Surname" type="S" value="Delgado" />
		<Attribute2 name="Address" type="S" value="Pirandello" />
		<Attribute5 name="Phone" type="N" value="637559681" />
		<Attribute6 name="Bonus" type="BOOL" value="true" />
		<Attribute7 name="Profession" type="S" value="Programmer" />
		<Attribute7 name="DocumentCode" type="B" value="qwrqfgdas1223455sdfffr" />
	</Item>
</RootElement>

Output

The adapter places the defined element in the desired table. In addition, the adapter outputs the same XML file that was entered during input. This can be useful for further operations.