CreateTable - Amazon-DynamoDB

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateTable

Wichtig

Dieser Abschnitt bezieht sich auf die veraltete API-Version 2011-12-05, die nicht für neue Anwendungen verwendet werden sollte.

Eine Dokumentation zur aktuellen Low-Level-API finden Sie in der Amazon DynamoDB-API-Referenz.

Beschreibung

Die CreateTable-Operation fügt dem Konto eine neue Tabelle hinzu.

Der Tabellenname muss zwischen denen, die dem AWS Konto zugeordnet sind, das die Anfrage ausstellt, und der AWS Region, die die Anfrage erhält, eindeutig sein (z. B. dynamodb.us-west-2.amazonaws.com). Jeder DynamoDB-Endpunkt ist vollständig unabhängig. Wenn Sie beispielsweise zwei Tabellen mit dem Namen "“ habenMyTable, eine in dynamodb.us-west-2.amazonaws.com und eine in dynamodb.us-west-1.amazonaws.com, sind sie völlig unabhängig und teilen sich keine Daten.

Die CreateTable-Operation löst eine asynchrone Workload aus, um mit der Erstellung der Tabelle zu beginnen. DynamoDB gibt unmittelbar den Status der Tabelle (CREATING) zurück, bis sich die Tabelle im Status ACTIVE befindet. Sobald sich die Tabelle im Status ACTIVE befindet, können Sie Datenebenenoperationen durchführen.

Verwenden Sie die DescribeTables-Operation, um den Status der Tabelle zu überprüfen.

Anforderungen

Syntax

// This header is abbreviated. // For a sample of a complete header, see DynamoDB auf niedriger Ebene API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} }
Name Beschreibung Erforderlich
TableName

Der Name der zu erstellenden Tabelle.

Zulässige Zeichen sind a-z, A-Z, 0-9, „_“ (Unterstrich), „-“ (Bindestrich) und „.“ (Punkt). Namen können zwischen 3 und 255 Zeichen lang sein.

Typ: Zeichenfolge

Ja
KeySchema

Die Struktur (einfach oder zusammengesetzt) des Primärschlüssels für die Tabelle. Ein Name-Wert-Paar ist für das HashKeyElement und optional für das RangeKeyElement erforderlich (nur für zusammengesetzte Primärschlüssel erforderlich). Weitere Informationen zu Primärschlüsseln finden Sie unter Primärschlüssel.

Elementnamen der Primärschlüssel können zwischen 1 und 255 Zeichen lang sein und unterliegen keinen Zeicheneinschränkungen.

Mögliche Werte für AttributeType sind „S“ (Zeichenfolge), „N“ (numerisch) oder „B“ (binär).

Typ: Zuordnung von HashKeyElement oder HashKeyElement und RangeKeyElement für einen zusammengesetzten Primärschlüssel.

Ja
ProvisionedThroughput Neuer Durchsatz für die angegebene Tabelle, bestehend aus Werten für ReadCapacityUnits und WriteCapacityUnits. Details hierzu finden Sie unter Bereitgestellter Kapazitätsmodus von DynamoDB.
Anmerkung

Aktuelle Höchst- und Mindestwerte finden Sie unter Service-, Konto- und Tabellenkontingente in Amazon DynamoDB.

Typ: Array

Ja
ProvisionedThroughput: ReadCapacityUnits

Legt die Mindestanzahl von konsistenten ReadCapacityUnits fest, die pro Sekunde für die angegebene Tabelle verbraucht wird, bevor DynamoDB die Last mit anderen Operationen ausgleicht.

Eventually Consistent-Leseoperationen erfordern weniger Aufwand als Consistent-Leseoperationen. Daher stellt die Festlegung von 50 konsistenten ReadCapacityUnits pro Sekunde 100 Eventually Consistent-ReadCapacityUnits pro Sekunde bereit.

Typ: Zahl

Ja
ProvisionedThroughput: WriteCapacityUnits Legt die Mindestanzahl von WriteCapacityUnits fest, die pro Sekunde für die angegebene Tabelle verbraucht wird, bevor DynamoDB die Last mit anderen Operationen ausgleicht.

Typ: Zahl

Ja

Antworten

Syntax

HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"CREATING" } }
Name Beschreibung
TableDescription Ein Container für die Eigenschaften der Tabelle.
CreationDateTime

Datum als die Tabelle in UNIX epoch time erstellt wurde.

Typ: Zahl

KeySchema

Die Struktur (einfach oder zusammengesetzt) des Primärschlüssels für die Tabelle. Ein Name-Wert-Paar ist für das HashKeyElement und optional für das RangeKeyElement erforderlich (nur für zusammengesetzte Primärschlüssel erforderlich). Weitere Informationen zu Primärschlüsseln finden Sie unter Primärschlüssel.

Typ: Zuordnung von HashKeyElement oder HashKeyElement und RangeKeyElement für einen zusammengesetzten Primärschlüssel.

ProvisionedThroughput

Der Durchsatz für eine angegebene Tabelle, bestehend aus Werten für ReadCapacityUnits und WriteCapacityUnits. Siehe Bereitgestellter Kapazitätsmodus von DynamoDB.

Typ: Array

ProvisionedThroughput :ReadCapacityUnits

Die minimale Anzahl von ReadCapacityUnits, die pro Sekunde verbraucht werden, bevor DynamoDB die Last mit anderen Operationen ausgleicht

Typ: Zahl

ProvisionedThroughput :WriteCapacityUnits

Die minimale Anzahl von ReadCapacityUnits, die pro Sekunde verbraucht werden, bevor WriteCapacityUnits die Last mit anderen Operationen ausgleicht

Typ: Zahl

TableName

Der Name der erstellten Tabelle.

Typ: Zeichenfolge

TableStatus

Der aktuelle Status der Tabelle (CREATING). Sobald sich die Tabelle im ACTIVE-Status befindet, können Sie in dieser Daten ablegen.

Verwenden Sie die DescribeTables-API, um den Status der Tabelle zu überprüfen.

Typ: Zeichenfolge

Spezielle Fehler

Fehler Beschreibung
ResourceInUseException Versuch, eine bereits vorhandene Tabelle neu zu erstellen.
LimitExceededException

Die Anzahl von gleichzeitigen Tabellenanforderungen (kumulative Anzahl von Tabellen im Status CREATING, DELETING oder UPDATING) überschreitet die maximal zulässige.

Anmerkung

Aktuelle Höchst- und Mindestwerte finden Sie unter Service-, Konto- und Tabellenkontingente in Amazon DynamoDB.

.

Beispiele

Das folgende Beispiel erstellt eine Tabelle mit einem zusammengesetzten Primärschlüssel, der eine Zeichenfolge und eine Zahl enthält. Beispiele für die Verwendung des AWS SDK finden Sie unterArbeiten mit Tabellen und Daten in DynamoDB.

Beispielanforderung

// This header is abbreviated. // For a sample of a complete header, see DynamoDB auf niedriger Ebene API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"comp-table", "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} }

Beispielantwort

HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"comp-table", "TableStatus":"CREATING" } }