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.
GetItem
Wichtig
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Eine Dokumentation zur aktuellen Low-Level-API finden Sie in der Amazon DynamoDB-API-Referenz.
Beschreibung
Die GetItem
-Operation gibt einen Attributes
-Satz für ein Element zurück, das mit dem Primärschlüssel übereinstimmt. Wenn kein passendes Element vorhanden ist, gibt GetItem
keine Daten zurück.
Die GetItem
-Operation stellt standardmäßig einen Eventually Consistent-Lesevorgang bereit. Wenn Eventually Consistent-Lesevorgänge für Ihre Anwendung nicht akzeptabel sind, verwenden Sie ConsistentRead
. Obwohl diese Operation länger dauern könnte als ein Standardlesevorgang, gibt sie immer den letzten aktualisierten Wert zurück. Weitere Informationen finden Sie unter DynamoDB-Lesekonsistenz.
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.GetItem content-type: application/x-amz-json-1.0 {"TableName":"Table1", "Key": {"HashKeyElement": {"S":"AttributeValue1"}, "RangeKeyElement": {"N":"AttributeValue2"} }, "AttributesToGet":["AttributeName3","AttributeName4"], "ConsistentRead":Boolean }
Name | Beschreibung | Erforderlich |
---|---|---|
TableName
|
Der Name der Tabelle, die das angeforderte Element enthält. Typ: Zeichenfolge |
Ja |
Key
|
Die Primärschlüsselwerte, die das Element definieren. Weitere Informationen zu Primärschlüsseln finden Sie unter Primärschlüssel. Typ: Zuordnung von |
Ja |
AttributesToGet
|
Array von Attributnamen. Wenn Attributnamen nicht angegeben sind, dann werden alle Attribute zurückgegeben. Wenn einige Attribute nicht gefunden werden, sind sie nicht im Abfrageergebnis enthalten. Typ: Array |
Nein |
ConsistentRead
|
Wenn auf Typ: Boolesch |
Nein |
Antworten
Syntax
HTTP/1.1 200 x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 content-type: application/x-amz-json-1.0 content-length: 144 {"Item":{ "AttributeName3":{"S":"AttributeValue3"}, "AttributeName4":{"N":"AttributeValue4"}, "AttributeName5":{"B":"dmFsdWU="} }, "ConsumedCapacityUnits": 0.5 }
Name | Beschreibung |
---|---|
Item
|
Enthält die angeforderten Attribute. Typ: Zuordnung von Attribut-Namen-Wert-Paare. |
ConsumedCapacityUnits |
Die Anzahl der Lesekapazitätseinheiten, die von der Operation verbraucht werden. Dieser Wert zeigt die Anzahl, die für Ihren bereitgestellten Durchsatz gültig ist. Anforderungen für nicht vorhandene Elemente verbrauchen je nach Typ des Lesevorgangs die Mindestlesekapazitätseinheiten. Weitere Informationen finden Sie unter Bereitgestellter Kapazitätsmodus von DynamoDB. Typ: Zahl |
Spezielle Fehler
Keine nur für diese Operation spezifischen Fehler.
Beispiele
Beispiele für die Verwendung des AWS SDK finden Sie unterArbeiten mit Elementen und Attributen in DynamoDB.
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.GetItem content-type: application/x-amz-json-1.0 {"TableName":"comptable", "Key": {"HashKeyElement":{"S":"Julie"}, "RangeKeyElement":{"N":"1307654345"}}, "AttributesToGet":["status","friends"], "ConsistentRead":true }
Beispielantwort
Beachten Sie, dass der ConsumedCapacityUnits Wert 1 ist, da der optionale Parameter auf gesetzt ConsistentRead
isttrue
. Wenn ConsistentRead
für dieselbe Anfrage auf gesetzt false
(oder nicht angegeben) wird, ist die Antwort letztlich konsistent und der ConsumedCapacityUnits Wert wäre 0,5.
HTTP/1.1 200 x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 content-type: application/x-amz-json-1.0 content-length: 72 {"Item": {"friends":{"SS":["Lynda, Aaron"]}, "status":{"S":"online"} }, "ConsumedCapacityUnits": 1 }