Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
penting
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Untuk dokumentasi tentang level rendah saat iniAPI, lihat Referensi Amazon DynamoDB API.
Deskripsi
Operasi GetItem mengembalikan sekumpulan Attributes untuk item yang cocok dengan kunci primer. Jika tidak ada item yang cocok, GetItem tidak mengembalikan data apa pun.
Operasi GetItem menyediakan bacaan akhir konsisten secara default. Jika bacaan akhir konsisten tidak dapat diterima untuk aplikasi Anda, gunakan ConsistentRead. Meskipun operasi ini mungkin memakan waktu lebih lama dari baca standar, operasi ini selalu mengembalikan nilai yang terakhir diperbarui. Untuk informasi selengkapnya, lihat DynamoDB membaca konsistensi.
Permintaan
Sintaks
// This header is abbreviated. // For a sample of a complete header, see DynamoDB tingkat rendah 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 }
| Nama | Deskripsi | Wajib |
|---|---|---|
TableName
|
Nama tabel yang berisi item yang diminta. Jenis: String |
Ya |
Key
|
Nilai kunci primer yang menentukan item. Untuk informasi selengkapnya tentang kunci primer, lihat Kunci primer. Jenis: Peta |
Ya |
AttributesToGet
|
Array Nama atribut. Jika nama atribut tidak ditentukan, semua atribut akan dikembalikan. Jika beberapa atribut tidak ditemukan, atribut tersebut tidak akan muncul dalam hasil. Jenis: Array |
Tidak |
ConsistentRead
|
Jika diatur ke Jenis: Boolean |
Tidak |
Respons
Sintaks
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
}| Nama | Deskripsi |
|---|---|
Item
|
Berisi atribut yang diminta. Jenis: Peta pasangan nama-nilai atribut. |
ConsumedCapacityUnits |
Jumlah unit kapasitas baca yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Permintaan untuk item yang tidak ada yang mengonsumsi unit kapasitas baca minimum, tergantung jenis baca. Untuk informasi selengkapnya, lihat DynamoDB menyediakan mode kapasitas. Jenis: Angka |
Kesalahan khusus
Tidak ada kesalahan khusus untuk operasi ini.
Contoh
Untuk contoh menggunakan AWS SDK, lihatBekerja dengan item dan atribut di DynamoDB.
Permintaan sampel
// This header is abbreviated. // For a sample of a complete header, see DynamoDB tingkat rendah 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 }
Respons sampel
Perhatikan ConsumedCapacityUnits nilainya adalah 1, karena parameter opsional ConsistentRead diatur ketrue. Jika ConsistentRead disetel ke false (atau tidak ditentukan) untuk permintaan yang sama, respons pada akhirnya konsisten dan ConsumedCapacityUnits nilainya akan menjadi 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
}