Operation: BatchGetMultipleItems

Mit der Operation BatchGetMultipleItems des Amazon S3 DynamoDB Connectors rufen Sie mehrere Elemente ab, abhängig von den Werten von partitionKey, die in einer XML-Datei spezifiziert sind.

Alle Elemente werden mit allen Elementattributen abgeholt.

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`	✳️ Diese Parameter sind erforderlich für diese Operation und müssen mit den Elementen übereinstimmen, die abgerufen werden sollen. 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`	✳️ Diese Parameter sind bei sortierbaren Schlüsseln erforderlich. 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
`readCapacityUnits`, `writeCapacitiyUnits`	Read/Write Capacity Units Mögliche Werte: Integer Capacity Units
`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:

Primary Keys können für verschiedene Objekte spezifiziert werden. Wenn das Objekt mit einer Tabelle übereinstimmt, in der nur partitionKey definiert ist, darf nur partitionKey angegeben werden, andernfalls partitionKey und SortKey.

<?xml version="1.0" encoding="UTF-8" ?>
<PrimaryKeyValues>
	<PrimaryKey partitionKey="2" SortKey="Carlos" />
	<PrimaryKey partitionKey="5" SortKey="Luis" />
</PrimaryKeyValues>

Output

Der Adapter ruft das spezifische Element aus der gewünschten Tabelle ab und gibt Daten in einer XML-Struktur aus.

Für jedes Element entsteht ein Item-Element mit Feldern für den Primärschlüssel und die dazugehörigen Werte. Innerhalb des Item-Elements findet sich eine Liste der dazugehörigen Attribute.

<?xml version="1.0" encoding="UTF-8" ?>
<Result>
	<Item partitionKey="ID" partitionKeyValue="5" SortKey="Name" SortKeyValue="Luis">
	<Attribute type="MAP" name="Cars">
			<Attribute type="N" name="Phone" value="637559681" />
			<Attribute type="BOOL" name="Bonus" value="true" />
			<Attribute type="B" name="DocumentCode" value="qwrqfgdas1223455sdfffr" />
	<Attribute type="S" name="Profession" value="Programmer" />
	</Attribute>
		<Attribute type="N" name="Phone" value="34666777888" />
	<Attribute type="LIST" name="Colours">
			<Attribute type="S" value="Red" />
			<Attribute type="S" value="Green" />
	<Attribute type="S" value="Blue" />
			<Attribute type="MAP" name="Colours">
				<Attribute type="N" name="Phone" value="637559681" />
				<Attribute type="BOOL" name="Bonus" value="true" />
				<Attribute type="B" name="DocumentCode" value="qwrqfgdas1223455sdfffr" />
				<Attribute type="S" name="Profession" value="Programmer" />
	</Attribute>
	</Attribute>
		<Attribute type="BOOL" name="Bonus" value="true" />
	</Item>
	<Item partitionKey="ID" partitionKeyValue="2" SortKey="Name" SortKeyValue="Carlos">
		<Attribute type="S" name="Address" value="Pirandello" />
		<Attribute type="N" name="Phone" value="637559681" />
		<Attribute type="BOOL" name="Bonus" value="true" />
	<Attribute type="B" name="DocumentCode" value="qwrqfgdas1223455sdfffr" />
		<Attribute type="S" name="Surname" value="Delgado" />
		<Attribute type="S" name="Profession" value="Programmer" />
	</Item>
</Result>