X4 Produktdokumentation

Operation: CreateTable

Mit der Operation CreateTable des Amazon S3 DynamoDB Connectors erstellen Sie eine Tabelle mit einem Tabellennamen und einem Primärschlüssel.

Weitere Informationen zu Primärschlüsseln finden Sie in der entsprechenden Amazon DynamoDB-Dokumentation:

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

✳️

Die Parameter partitionKey und partitionType sind erforderlich für diese Operation.

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

✳️

Die Parameter sortKey, sortType 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

scalableType

✳️

Dieser Parameter ist erforderlich für diese Operation, wenn Sie AutoScaling aktivieren.

Definiert den Skalierbarkeitstyp für AutoScaling.

Mögliche Werte:

  • ReadCapacity

  • WriteCapacity

autoScaling

Legt fest, dass die Tabelle mithilfe von AutoScaling erstellt wird. Im Fall einer Überprüfung müssen alle Scaling-Parameter angegeben werden.

Mögliche Werte:

  • true

  • false

scalingMinCapacity, scalingMaxCapacity, scalingTargetValue, scalingInCooldown, scalingOutCooldown

✳️

Diese Parameter sind erforderlich für diese Operation, wenn Sie AutoScaling aktivieren.

Definiert die Scaling-Parameter für AutoScaling.

Mögliche Werte:

Weitere Informationen finden Sie in der entsprechenden Amazon DynamoDB-Dokumentation:

arnRole

✳️

Dieser Parameter ist erforderlich für diese Operation, wenn Sie AutoScaling aktivieren.

ARN der Rolle, die autorisiert ist, AutoScaling für die Tabellenressource anzuwenden.

Mögliche Werte:

Weitere Informationen finden Sie in der entsprechenden Amazon DynamoDB-Dokumentation:

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.

Output

Der Adapter erstellt eine Tabelle mit dem festgelegten Tabellennamen und Primärschlüssel.