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 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 |
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. AnmerkungAktuelle Höchst- und Mindestwerte finden Sie unter Service-, Konto- und Tabellenkontingente in Amazon DynamoDB. Typ: Array |
Ja |
ProvisionedThroughput :
ReadCapacityUnits |
Legt die Mindestanzahl von konsistenten Eventually Consistent-Leseoperationen erfordern weniger Aufwand als Consistent-Leseoperationen. Daher stellt die Festlegung von 50 konsistenten 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 Typ: Zahl |
KeySchema
|
Die Struktur (einfach oder zusammengesetzt) des Primärschlüssels für die Tabelle. Ein Name-Wert-Paar ist für das Typ: Zuordnung von |
ProvisionedThroughput
|
Der Durchsatz für eine angegebene Tabelle, bestehend aus Werten für Typ: Array |
ProvisionedThroughput
:ReadCapacityUnits |
Die minimale Anzahl von Typ: Zahl |
ProvisionedThroughput
:WriteCapacityUnits |
Die minimale Anzahl von Typ: Zahl |
TableName
|
Der Name der erstellten Tabelle. Typ: Zeichenfolge |
TableStatus
|
Der aktuelle Status der Tabelle ( 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 AnmerkungAktuelle 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" } }