X4 Produktdokumentation

Operation: BatchPutMultipleItems

Mit der Operation BatchPutMultipleItems des Amazon S3 DynamoDB Connectors fügen Sie mehrere Elemente in einem einzigen Aufruf in eine Tabelle ein.

Weitere Informationen zu anderen Operationen des Amazon S3 DynamoDB Connectors finden Sie unter Amazon S3 DynamoDB Connector.

Parameter

keyID

Zugangsschlüssel-ID für Anfragen an AWS (Amazon Web Services)

Hinweis:

Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten. Weitere Informationen finden Sie unter Zugangsdaten einrichten.

Mögliche Werte:

Beliebige Zeichenkette mit der Zugangsschlüssel-ID, z. B.  AKIAIOSFODNN7EXAMPLE

secretKey

Geheimer Zugangsschlüssel für Anfragen an AWS

Hinweis:

Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten. Weitere Informationen finden Sie unter Zugangsdaten einrichten.

Mögliche Werte:

Beliebige Zeichenkette mit der geheimen Zugangsschlüssel, z. B.  wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

region

Region der Domains

Hinweis:

Buckets, die in einer bestimmten Region erstellt wurden, können nicht von einer anderen Region aus aufgerufen werden. Weitere Informationen finden Sie unter Regionen und Endpoints.

Mögliche Werte:

Beliebige Zeichenkette mit dem Namen der Region, z. B.  us-east-2

tableName

✳️

Dieser Parameter ist erforderlich für diese Operation.

Tabellen-Name

Mögliche Werte:

Zeichenkette mit dem Tabellen-Namen nach folgenden Namensregeln:

  • Alle Namen müssen UTF-8-kodiert sein

  • Die Groß- und Kleinschreibung muss beachtet werden

  • Tabellennamen und Indexnamen müssen zwischen 3 und 255 Zeichen lang sein und dürfen nur folgende Zeichen enthalten:

    • a-z

    • A-Z

    • 0-9

    • _ (Unterstrich)

    • - (Bindestrich)

    • . (Punkt)

  • Attributnamen müssen zwischen 1 und 255 Zeichen lang sein.

partitionKey, partitionType und partitionKeyValue

Elemente des Tabellen-Primärschlüssels

Mögliche Werte:

  • PartitionKey: Name des Partitionsschlüssels

  • PartitionType: Partitionstyp

    • S: Das Attribut ist eine Zeichenkette

    • N: Das Attribut ist eine Zahl

    • B: Das Attribut ist vom Typ Binär

  • PartitionKeyValue: Wert des Elements

sortKey, sortType und sortKeyValue

Elemente des Tabellen-Primärschlüssels

Mögliche Werte:

  • SortKey: Name des Sortierschlüssels

  • SortType: Sortiertyp

    • S: Das Attribut ist eine Zeichenkette

    • N: Das Attribut ist eine Zahl

    • B: Das Attribut ist vom Typ Binär

  • SortKeyValue: Wert des Elements

consistentRead

DynamoDB verwendet Eventually Consistent Reads, sofern nichts anderes angeben ist. Leseoperationen wie GetItem und Query liefern einen ConsistentRead-Parameter. Wenn dieser Parameter auf true gesetzt ist, verwendet DynamoDB während des Betriebs Strongly Consistent Reads.

Statuswerte

1

Die Operation wurde erfolgreich ausgeführt

0

Die Operation wurde nicht vollständig ausgeführt, es ist aber kein Fehler aufgetreten.

-1

Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Der Adapter erwartet eine vordefinierte XML-Struktur als Input.

Hinweis:

Sie können mehrere Items spezifizieren. In den Items können Attribute vom Typ Boolean (BOOL), String (S), Number (N), Map (MAP), List (LIST) und Binary (B) spezifiziert werden. Der Output dieser Operation ist dieselbe XML-Datei. Das kann für weitere Operationen nützlich sein.

<?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

Der Adapter platziert die definierten Element in der gewünschten Tabelle. Außerdem gibt der Adapter dieselbe XML-Datei aus, die beim Input eingegeben wurde. Das kann für weitere Operationen nützlich sein.