Skip to main content
Skip table of contents

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:

  • CreateDomain: Legt eine Domain mit Datensätzen an.
    Erforderliche Parameter: domain

  • DomainMetadata: Ruft Metadaten zu einer Domain auf, siehe DomainMetadata im offiziellen Handbuch.
    Erforderliche Parameter: domain

  • DeleteDomain: Löscht eine Domain.
    Erforderliche Parameter: domain

  • ListDomain: Listet alle Domains auf.

  • Put: Fügt ein Element und seine Attribute hinzu oder aktualisiert sie, oder fügt Attribut-Wert-Paare zu einem bereits vorhandenen Element hinzu; Das Element wird beim Empfang automatisch indiziert. Gemäß dem Parameter replaceExistingAttributes ersetzt der Inhalt bestehende Attribute oder erstellt neue Attribute, wobei auch die aktuellen Attribute erhalten bleiben.
    Erforderliche Parameter: domain, replaceExistingAttributes

  • BatchPutAttributesFügt bis zu 25 Put-Operationen in einem einzigen Anruf hinzu oder aktualisiert sie. Elemente werden beim Empfang automatisch indiziert. Gemäß dem Parameter replaceExistingAttributes ersetzt der Inhalt bestehende Attribute oder erstellt neue Attribute, wobei auch die aktuellen Attribute erhalten bleiben, siehe BatchPutAttributes im offiziellen Handbuch.
    Erforderliche Parameter: domain, replaceExistingAttributes

  • GetItem: Ruft ein Element und alle oder eine Teilmenge seiner Attribute und Werte ab.
    Erforderliche Parameter: domain, itemName

  • DeleteItem: Löscht ein Element, ein Attribut oder einen Attribut-Wert.
    Erforderliche Parameter: domain, itemName

  • BatchDeleteAttributes: Löscht bis zu 25 Delete-Operationen in einem einzigen Anruf, siehe BatchDeleteAttributes im offiziellen Handbuch.
    Erforderliche Parameter: domain

  • Select: Fragt einen Datensatz gemäß der typischen Abfragesyntax “select target from domain_name where query_expression” ab.
    Unterstützte Wertetests sind: =, !=, like, not like, between, is null, is not null, und every ().
    Beispiel: select * from mydomain where every(keyword) = ‘Book’.
    (info) Ordnen Sie Ergebnisse mit dem Operator SORT und zählen Sie Elemente, welche die Abfragebedingung(en) erfüllen, mit dem Operator Count.

  • StoreAmazonS3ObjectMetadata: Speichert die Metadaten zu einem AmazonS3-Objekt in der im Parameter domain spezifizierten Domain.
    Erforderliche Parameter: domain, replaceExistingAttributes

Parameter

Adapter

Adapter-Hauptklasse (nicht verändern!)

Mögliche Werte: de.softproject.integration.adapter.amazonsimpledb.AmazonSimpleDBAdapter: Hauptklasse (Standard)

keyId

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

(info) Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten, siehe Zugangsdaten einrichten.

Mögliche Werte: Beliebige Zeichenkette mit der Zugangsschlüssel-ID, z. B. AKIAIOSFODNN7EXAMPLE

secretKey

Geheimer Zugangsschlüssel für Anfragen an AWS

(info) Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten, siehe Zugangsdaten einrichten.

Mögliche Werte: Beliebige Zeichenkette mit der geheimen Zugangsschlüssel, z. B. wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

region

Region der Domains 

Mögliche Werte: Beliebige Zeichenkette mit dem Namen der Region, z. B. us-east-2

(info) Buckets, die in einer bestimmten Region erstellt wurden, können nicht von einer anderen Region aus aufgerufen werden, siehe Regionen und Endpoints.

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: a-z, A-Z, 0-9, '_', '-' und '.'.

(info) Es können Abfragen gegen eine Domain, jedoch nicht zwischen verschiedenen Domains ausgeführt werden.

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 Put und BatchPutAttributes.

Status

1

Die Adapter-Operation wurde erfolgreich ausgeführt

0Die Domain existiert nicht
-1Bei 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 Operation BatchPutAttributes verwenden. Es gibt keine Einschränkungen bei den Elementnamen, allerdings ist das Attribut name 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 Operation Put verwenden. Es gibt keine Einschränkungen bei den Elementnamen, allerdings ist das Attribut name 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-Eigenschaft includeObjectsMetadata 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 Werte STANDARD_METADATA oder USER_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>

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.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.