GetItem - Amazon DynamoDB
BeschreibungAnforderungenAntwortenSpezielle FehlerBeispiele

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

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 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 HashKeyElement zu seinem Wert und von RangeKeyElement zu seinem Wert.

 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 true festgelegt, dann wird ein Consistent-Lesevorgang ausgegeben, andernfalls wird Eventually Consistent verwendet.

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 DynamoDB – Modus mit bereitgestellter Kapazität.

Typ: Zahl

Spezielle Fehler

Keine nur für diese Operation spezifischen Fehler.

Beispiele

Beispiele für die Verwendung des AWS SDK finden Sie unter Arbeiten 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 Wert für die verbrauchten Kapazitätseinheiten 1 ist, weil der optionale Parameter ConsistentRead auf true festgelegt ist. Wenn ConsistentRead für die gleiche Anforderung auf false festgelegt ist (oder nicht angegeben ist), ist die Antwort Eventually Consistent und der Wert für die verbrauchten Kapazitätseinheiten 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
}