GetItem - Amazon DynamoDB
DescrizioneRichiesteRisposteErrori specialiEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

GetItem

Importante

In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.

Per informazioni sull'API di basso livello corrente, consulta la Amazon DynamoDB API Reference.

Descrizione

L'operazione GetItemrestituisce un set di Attributes per un elemento che corrisponde alla chiave primaria. Se non viene trovato un elemento corrispondente, GetItem non restituisce alcun dato.

Per impostazione predefinita, l'operazione GetItem usa le letture a consistenza finali. Se le letture a consistenza finale non sono accettabili per l'applicazione, utilizza ConsistentRead. Sebbene questa operazione possa richiedere più tempo di una lettura standard, restituisce sempre l'ultimo valore aggiornato. Per ulteriori informazioni, consulta Coerenza di lettura di DynamoDB.

Richieste

Sintassi

// This header is abbreviated.
// For a sample of a complete header, see API DynamoDB di basso livello.
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
}
Nome Descrizione Richiesto
TableName

Il nome della tabella che contiene gli elementi richiesti.

Tipo: string

 Sì
Key

I valori della chiave primaria che definiscono l'elemento. Per ulteriori informazioni sulle chiavi primarie, vedere Chiave primaria.

Tipo: mappa di HashKeyElement sul suo valore e RangeKeyElement sul suo valore.

 Sì
AttributesToGet

Matrice di nomi di attributi. Se i nomi degli attributi non sono specificati, verranno restituiti tutti gli attributi. Se alcuni attributi non vengono trovati, non verranno visualizzati nel risultato.

Tipo: Array

 No
ConsistentRead

Se impostato su true, viene emessa una lettura consistente, altrimenti viene utilizzata la consistenza finale.

Tipo: Booleano

 No

Risposte

Sintassi

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
}
Nome Descrizione
Item

Contiene gli attributi richiesti.

Tipo: mappa di coppie nome-valore dell'attributo.
ConsumedCapacityUnits

Il numero di unità di capacità di scrittura utilizzate dall'operazione. Questo valore mostra il numero applicato alla velocità effettiva assegnata. Le richieste di elementi inesistenti consumano le unità di capacità di lettura minima in base al tipo di lettura. Per ulteriori informazioni, consulta Modalità con capacità allocata di DynamoDB.

Tipo: numero

Errori speciali

Nessun errore specifico per questa operazione.

Esempi

Per gli esempi di utilizzo dell'SDK AWS, consulta Utilizzo di elementi e attributi in DynamoDB.

Richiesta di esempio

// This header is abbreviated.
// For a sample of a complete header, see API DynamoDB di basso livello.
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
}

Risposta di esempio

Si noti che il valore di ConsumedCapacityUnits è 1, poiché il parametro facoltativo ConsistentRead è impostato su true. Se ConsistentRead è impostato su false (o se non è specificato) per la stessa richiesta, la risposta è a consistenza finale e il valore ConsumedCapacityUnits sarebbe 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
}