Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

GetItem

重要

本节引用 API 版本 2011-12-05,此版本已被弃用且不应该用于新应用程序。

有关当前低级 API 的文档,请参阅 Amazon DynamoDB API Reference

说明

GetItem 操作返回与主键匹配的项目的一组 Attributes。如果没有匹配项目,GetItem 将不返回任何数据。

默认情况下,GetItem 操作提供最终一致性读取。如果您的应用程序无法接受最终一致性读取,请使用 ConsistentRead。虽然此操作花费的时间可能长于标准读取,但是此操作始终返回最后更新的值。有关更多信息,请参阅 读取一致性

请求

语法

Copy
// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 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 }

名称 描述 必需
TableName

包含所请求项目的表的名称。

类型:字符串

Key

用于定义项目的主键值。有关主键的更多信息,请参阅 主键

类型:HashKeyElement 到其值以及 RangeKeyElement 到其值的映射。

AttributesToGet

属性名称数组。如果未指定属性名称,则将返回所有属性。如果未找到某些属性,则不会在结果中显示这些属性。

类型:数组

ConsistentRead

如果设置为 true,则使用一致性读取,否则使用最终一致性。

类型:布尔值

响应

语法

Copy
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 }

名称 描述
Item

包含所请求的属性。

类型:属性名称/值对的映射。

ConsumedCapacityUnits

操作占用的读取容量单位数。此值显示根据预配置吞吐量应用的数量。请求不存在的项目将占用最小数量的读取容量单位,具体取决于读取类型。有关更多信息,请参阅 读取和写入的吞吐量设置

类型:数字

特殊错误

没有特定于此操作的错误。

示例

有关使用 AWS 开发工具包的示例,请参阅 在 DynamoDB 中处理项目

示例请求

Copy
// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 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 }

示例响应

请注意,ConsumedCapacityUnits 值为 1,因为可选参数 ConsistentRead 设置为 true。如果同一请求的 ConsistentRead 设置为 false(或未指定),则响应是最终一致的,并且 ConsumedCapacityUnits 值将为 0.5。

Copy
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 }