DescribeTables

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

Gibt Informationen über die Tabelle zurück, einschließlich des aktuellen Status der Tabelle, des Primärschlüsselschemas und des Erstellungszeitpunkts der Tabelle. DescribeTable Die Ergebnisse sind letztendlich konsistent. Wenn Sie DescribeTable zu früh bei der Erstellung einer Tabelle verwenden, gibt DynamoDB a zurück. ResourceNotFoundException Wenn Sie den Wert DescribeTable zu früh beim Aktualisieren einer Tabelle verwenden, sind die neuen Werte möglicherweise nicht sofort verfügbar.

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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}

Name	Beschreibung	Erforderlich
TableName	Der Name der zu beschreibenden Tabelle. Typ: Zeichenfolge	Ja

Antworten

Syntax

HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
Content-Length: 543


{"Table":
    {"CreationDateTime":1.309988345372E9,
    ItemCount:1,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": Date, "LastDecreaseDateTime": Date, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableSizeBytes":1,
    "TableStatus":"ACTIVE"
    }
}

Name	Beschreibung
Table	Container für die Tabelle, die beschrieben wird Typ: Zeichenfolge
CreationDateTime	Datum als die Tabelle in UNIX epoch time erstellt wurde.
ItemCount	Anzahl der Elemente in der angegebenen Tabelle DynamoDB aktualisiert diesen Wert ca. alle sechs Stunden. Neueste Änderungen werden in diesem Wert möglicherweise nicht wiedergegeben. 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). Die maximale Hash-Schlüsselgröße ist 2048 Byte. Die maximale Range-Schlüsselgröße ist 1024 Byte. Beide Grenzen werden separat durchgesetzt (d. h. Sie können einen kombinierten Hash + Range 2048 + 1024-Schlüssel haben). Weitere Informationen zu Primärschlüsseln finden Sie unter Primärschlüssel.
ProvisionedThroughput	Der Durchsatz für die angegebene Tabelle, bestehend aus Werten für LastIncreaseDateTime (falls zutreffend), LastDecreaseDateTime (falls zutreffend), ReadCapacityUnits und WriteCapacityUnits. Wenn der Durchsatz für die Tabelle noch nie erhöht oder verringert wurde, gibt DynamoDB keine Werte für diese Elemente zurück. Siehe Bereitgestellter Kapazitätsmodus von DynamoDB. Typ: Array
TableName	Der Name der angeforderten Tabelle. Typ: Zeichenfolge
TableSizeBytes	Die Gesamtgröße der angegebenen Tabelle in Bytes. DynamoDB aktualisiert diesen Wert ca. alle sechs Stunden. Neueste Änderungen werden in diesem Wert möglicherweise nicht wiedergegeben. Typ: Zahl
TableStatus	Der aktuelle Status der Tabelle (CREATING, ACTIVE, DELETING oder UPDATING). Sobald sich die Tabelle in dem ACTIVE-Status befindet, können Sie Daten hinzufügen.

Spezielle Fehler

Keine Fehler sind für diese Operation spezifisch.

Beispiele

Die folgenden Beispiele zeigen eine HTTP-POST-Anforderung und -Antwort, bei der der DescribeTable Vorgang für eine Tabelle mit dem Namen „comp-table“ verwendet wird. Die Tabelle verfügt über einen zusammengesetzten Primärschlüssel.

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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"users"}

Beispielantwort

HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 543

{"Table":
    {"CreationDateTime":1.309988345372E9,
    "ItemCount":23,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": 1.309988345384E9, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"users",
    "TableSizeBytes":949,
    "TableStatus":"ACTIVE"
    }
}

Zugehörige Aktionen

• CreateTable

• DeleteTable

• ListTables