Amazon SimpleDB Connector
Dieser Adapter verwaltet Daten und deren Strukturen in Amazon S3 SimpleDB. Amazon SimpleDB ist ein hochverfügbarer NoSQL-Datenspeicher, der die Arbeit der Datenbankverwaltung entlastet.
Eigenschaften (Properties)
Operation | Vom Adapter ausgeführte Operation Mögliche Werte:
|
Parameter
Adapter | Adapter-Hauptklasse (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.amazonsimpledb.AmazonSimpleDBAdapter: Hauptklasse (Standard) |
| Zugangsschlüssel-ID für Anfragen an AWS (Amazon Web Services)
Mögliche Werte: Beliebige Zeichenkette mit der Zugangsschlüssel-ID, z. B. |
secretKey | Geheimer Zugangsschlüssel für Anfragen an AWS
Mögliche Werte: Beliebige Zeichenkette mit der geheimen Zugangsschlüssel, z. B. |
region | Region der Domains Mögliche Werte: Beliebige Zeichenkette mit dem Namen der Region, z. B.
|
domain | Domain-Name, der durch einen eindeutigen Schlüssel (Namen) identifiziert wird. Domains werden durch Domain-Registerkarten am unteren Rand der Tabelle dargestellt und ähneln Tabellen mit ähnlichen Daten. Der Name muss zwischen 3 und 255 Zeichen lang sein und kann folgende Zeichen enthalten:
|
itemName | Element-Name Elemente werden durch Zeilen dargestellt und sind Einzelobjekte, die ein oder mehrere Attribut-Namens-Wertepaare enthalten. |
replaceExistingAttributes | Gibt an, ob der zu setzende Inhalt den bestehenden überschreibt, wenn das zu setzende Element) ein gemeinsames Attribut enthält. Gilt für die Operationen |
Status
1 | Die Adapter-Operation wurde erfolgreich ausgeführt |
0 | Die Domain existiert nicht |
-1 | Bei der Ausführung des Adapters kam es zu einem Fehler |
Input
Der Adapter erwartet ein XML-Dokument als Input
Operation
Put
:XML<?xml version="1.0" encoding="UTF-8" <ListAttributes> <item name="..Item name.."> <Attribute name="..Name of Attribute.." value="..Value of Attribute.."/> <!-- As many attributes as required --> </item> </ListAttributes>
Bei der Operation
Put
sollte nur ein Element-Attribut angegeben werden. Wenn Operationen für mehr als ein Element ausgeführt werden sollen, die OperationBatchPutAttributes
verwenden. Es gibt keine Einschränkungen bei den Elementnamen, allerdings ist das Attributname
erforderlich.Operation
BatchPutAttributes
:XML<?xml version="1.0" encoding="UTF-8" <ListAttributes> <item name="..Item name.."> <Attribute name="..Name of attribute.." value="..Value of attribute.."/> <!-- As many attributes as required --> </item> <!-- As many items as required --> </ListAttributes>
Bei der Operation
BatchPutAttributes
sollten mehrere Element-Attribute angegeben werden. Wenn Operationen für ein einziges Element ausgeführt werden sollen, die OperationPut
verwenden. Es gibt keine Einschränkungen bei den Elementnamen, allerdings ist das Attributname
erforderlich.Operation
Select
:XML<?xml version="1.0" encoding="UTF-8" <RootElement> <queryStatement> select * from 'DomainName' </queryStatement> </RootElement>
Das Element
queryStatement
wird benötigt. Für eine korrekte Abfrage, folgende Anleitung befolgen.Operation
BatchDeleteAttributes
:XML<?xml version="1.0" encoding="UTF-8" <Items> <item name="HR employee"> <Attribute1 name="ID" value="00002"/> </item> <item3 name="DEV employee"> <Attribute1 name="ID" value="00003"/> <Attribute2 name="Address" value="C\Ettlingen"/> <Attribute3 name="Name" value="Lorena"/> <Attribute4 name="Frameworks" value="Java-Hibernate"/> <Attribute4 name="Frameworks" value="Angular"/> </item> </Items>
Operation
StoreAmazonS3ObjectMetadata
:XML<?xml version='1.0' encoding='UTF-8'?> <ListBucket> <Bucket name="SoftProject-bucket" region="eu-west-1"> <Object name="myFile.xml" url="https://s3-eu-west-1.amazonaws.com/test-malaga2/myFile.xml"> <Metadata lastModified="2018-12-10 13:42:38.000 +0100" instanceLength="158" eTag="a933d9ca99b473c7921c496727a32f91" contentType="application/octet-stream" contentLength="158"/> </Object> <Object name="myFile2.xml" url="https://s3-eu-west-1.amazonaws.com/test-malaga2/myFile2.xml"> <Metadata lastModified="2018-12-10 12:02:07.000 +0100" instanceLength="158" eTag="a933d9ca99b473c7921c496727a32f91" contentType="application/octet-stream" contentLength="158" contentLanguage="English"/> </Object> </Bucket> </ListBucket>
- Die erwartete Input-XML-Struktur kann mithilfe der Operation
Search
des Amazon S3 Simple Storage Connectors erzeugt werden. Dabei muss die Adapter-EigenschaftincludeObjectsMetadata
aktiviert sein. - Gespeicherte Attribute für die einzelnen Objekt-Metadaten müssen mit den Amazon-Metadatenfeldern übereinstimmen. Weitere Informationen hierzu finden Sie unter Object Key and Metadata.
Zusätzlich zu den bereitgestellten Metadatenfeldern wird ein neues Feld gespeichert, um die Metadaten filtern zu können. Das Feld
metadataType
liefert die WerteSTANDARD_METADATA
oderUSER_METADATA
oder beide, wenn sowohl Standard- als auch Benutzerfelder vorhanden sind. Weitere Informationen hierzu finden Sie unter Object metadata.XML<?xmlversion='1.0'encoding='UTF-8'?> <ListBucket> <Bucketname="testmalaga2"region="euwest1"> <Objectname="testing_folders/personalData.txt"url="https://s3euwest1.amazonaws.com/testmalaga2/testing_folders/personalData.txt"> <MetadatalastModified="2018-12-10 12:30:35.000 +0100"instanceLength="33"eTag="7960fb01e91834eb9d5ccbacdf45d0e5"contentType="application/octetstream"contentLength="33"contentLanguage="Spanish"/> <UserMetadataciudad="Malaga"/> </Object> </Bucket> </ListBucket>
- Die erwartete Input-XML-Struktur kann mithilfe der Operation
Output
Der Adapter gibt je nach ausgeführter Operation unterschiedliche Arten von Dokumenten zurück:
Operation
ListDomain
:XML<?xml version="1.0" encoding="UTF-8" <ListDomain> <Domain name="Domain Name"> </ListDomain>
Operation
GetItem
:XML<?xml version="1.0" encoding="UTF-8" <Result> <Item id="Item Name"> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> </Item> </Result>
Operation
Select
:XML<?xml version="1.0" encoding="UTF-8" <Result> <Item id="Item1 Name"> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> </Item> <Item id="Item2 Name"> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> </Item> <Item id="Item3 Name"> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> <Attribute name="Attribute name" value="Attribute value"/> </Item> </Result>
- Alle anderen Operationen geben das Input-Dokument zurück.