DescribeTables - Amazon DynamoDB
BeschreibungAnforderungenAntwortenSpezielle FehlerBeispieleZugehörige Aktionen

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.

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, einschließlich ihrem aktuellen Status, das Primärschlüsselschema und den Zeitpunkt der Tabellenerstellung zurück. DescribeTables-Ergebnisse sind Eventually Consistent. Wenn Sie DescribeTables bei der Erstellung einer Tabelle zu früh verwenden, gibt DynamoDB eine ResourceNotFoundException zurück. Wenn Sie DescribeTables bei der Aktualisierung einer Tabelle zu früh verwenden, werden die neuen Werte möglicherweise nicht sofort verfügbar sind.

Anforderungen

Syntax

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB Low-Level-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 DynamoDB – Modus mit bereitgestellter Kapazität.

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 mithilfe der "DescribeTable"-Operation für eine Tabelle mit dem Namen "comp-table". Die Tabelle verfügt über einen zusammengesetzten Primärschlüssel.

Beispielanforderung

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB Low-Level-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"
    }
}