Amazon DynamoDB
Developer Guide (API Version 2012-08-10)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Document History for Amazon DynamoDB

This Document History describes the important changes to the documentation in this release of Amazon DynamoDB.

Relevant Dates to this History:

  • Current product version—2012-08-10

  • Latest product release—14 May 2013

  • Last document update—14 May 2013

ChangeDescriptionRelease Date
4 KB read capacity unit sizeIn this release, the capacity unit size for reads has increased from 1 KB to 4 KB. This enhancement can reduce the number of provisioned read capacity units required for many applications. For example, prior to this release, reading a 10 KB item would consume 10 read capacity units; now that same 10 KB read would consume only 3 units (10 KB / 4 KB, rounded up to the next 4 KB boundary). For more information, see Provisioned Throughput in Amazon DynamoDB.In this release
Parallel scansAmazon DynamoDB adds support for parallel Scan operations. Applications can now divide a table into logical segments and scan all of the segments simultaneously. This feature reduces the time required for a Scan to complete, and fully utilizes a table's provisioned read capacity. For more information, see Parallel Scan.In this release
Local secondary indexesAmazon DynamoDB adds support for local secondary indexes. You can define alternate range indexes on non-key attributes, and then use these indexes in Query requests. With local secondary indexes, applications can efficiently retrieve data items across multiple dimensions. For more information, see Local Secondary Indexes.18 April 2013
New API versionWith this release, Amazon DynamoDB introduces a new API version (2012-08-10). The previous API version (2011-12-05) is still supported for backward compatibility with existing applications. New applications should use the new API version 2012-08-10. We recommend that you migrate your existing applications to API version 2012-08-10, since new Amazon DynamoDB features (such as local secondary indexes) will not be backported to the previous API version. For more information on API version 2012-08-10, go to the Amazon DynamoDB API Reference.18 April 2013
IAM policy variable support

The IAM access policy language now supports variables. When a policy is evaluated, any policy variables are replaced with values that are supplied by context-based information from the authenticated user’s session. You can use policy variables to define general purpose policies without explicitly listing all the components of the policy. For more information about policy variables, go to Policy Variables in the AWS Identity and Access Management Using IAM guide.

For examples of policy variables in Amazon DynamoDB, see Controlling Access to Amazon DynamoDB Resources.

4 April 2013
PHP code samples updated for AWS SDK for PHP version 2Version 2 of the AWS SDK for PHP is now available. The PHP code samples in the Amazon DynamoDB Developer Guide have been updated to use this new SDK. For more information on Version 2 of the SDK, see AWS SDK for PHP.23 Jan 2013
New endpointAmazon DynamoDB expands to the AWS GovCloud (US) Region. For the current list of service endpoints and protocols, see AWS GovCloud (US) Region.3 Dec 2012
New endpointAmazon DynamoDB expands to the South America (Sao Paulo) Region. For the current list of supported endpoints, see Regions and Endpoints.3 Dec 2012
New endpointAmazon DynamoDB expands to the Asia Pacific (Sydney) Region. For the current list of supported endpoints, see Regions and Endpoints.13 Nov 2012

Amazon DynamoDB implements support for CRC32 checksums, supports strongly consistent batch gets, and removes restrictions on concurrent table updates.

  • Amazon DynamoDB calculates a CRC32 checksum of the HTTP payload and returns this checksum in a new header, x-amz-crc32. For more information, see Making HTTP Requests to Amazon DynamoDB.

  • By default, read operations performed by the BatchGetItem API are eventually consistent. A new ConsistentRead parameter in BatchGetItem lets you choose strong read consistency instead, for any table(s) in the request. For more information, see Description.

  • This release removes some restrictions when updating many tables simultaneously. The total number of tables that can be updated at once is still 10; however, these tables can now be any combination of CREATING, UPDATING or DELETING status. Additionally, there is no longer any minimum amount for increasing or reducing the ReadCapacityUnits or WriteCapacityUnits for a table. For more information, see Limits in Amazon DynamoDB.

2 Nov 2012

Best practices documentation

The Amazon DynamoDB Developer Guide identifies best practices for working with tables and items, along with recommendations for query and scan operations.

28 Sep 2012

Support for binary data type

In addition to the Number and String types, Amazon DynamoDB now supports Binary data type.

Prior to this release, to store binary data, you converted your binary data into string format and stored it in Amazon DynamoDB. In addition to the required conversion work on the client-side, the conversion often increased the size of the data item requiring more storage and potentially additional provisioned throughput capacity.

With the binary type attributes you can now store any binary data, for example compressed data, encrypted data, and images. For more information see Amazon DynamoDB Data Types. For working examples of handling binary type data using the AWS SDKs, see the following sections:

For the added binary data type support in the AWS SDKs, you will need to download the latest SDKs and you might also need to update any existing applications. For information about downloading the AWS SDKs, see Using the AWS SDKs with Amazon DynamoDB.

21 Aug 2012

Amazon DynamoDB table items can be updated and copied using the Amazon DynamoDB console

Amazon DynamoDB users can now update and copy table items using the Amazon DynamoDB Console, in addition to being able to add and delete items. This new functionality simplifies making changes to individual items through the Console. For more information, see the Working with Items Using the Amazon DynamoDB Console topic in the Amazon DynamoDB Developer Guide.

14 Aug 2012

Amazon DynamoDB lowers minimum table throughput requirements

DynamoDB now supports lower minimum table throughput requirements, specifically 1 write capacity unit and 1 read capacity unit. For more information, see the Limits in Amazon DynamoDB topic in the Amazon DynamoDB Developer Guide.

9 Aug 2012

Amazon DynamoDB and Amazon Elastic MapReduce (EMR) integration video and walkthrough added

For more information, see Using Amazon DynamoDB and Amazon Elastic MapReduce.

5 Jul 2012

Signature Version 4 support

Amazon DynamoDB now supports Signature Version 4 for authenticating requests. To learn about authenticating your HTTP requests, see Making HTTP Requests to Amazon DynamoDB.

5 Jul 2012

Table explorer support in Amazon DynamoDB Console

The Amazon DynamoDB Console now supports a table explorer that enables you to browse and query the data in your tables. You can also insert new items or delete existing items. The Getting Started and The Amazon DynamoDB Console sections have been updated for these features.

22 May 2012

New endpoints

Amazon DynamoDB availability expands with new endpoints in the US West (Northern California) Region, US West (Oregon) Region, and the Asia Pacific (Singapore) Region.

For the current list of supported endpoints, go to Regions and Endpoints.

24 April 2012

BatchWriteItem API support

Amazon DynamoDB now supports a batch write API that enables you to put and delete several items from one or more tables in a single API call. For more information about the Amazon DynamoDB batch write API, see BatchWriteItem.

For information about working with items and using batch write feature using AWS SDKs, see Working with Items and Using the AWS SDKs with Amazon DynamoDB.

19 April 2012

Documented more error codes

For more information, see Handling Errors.

5 April 2012

Added "Getting Started with Amazon DynamoDB" video

A video is now embedded in the Amazon DynamoDB Developer Guide to provide an overview of the service and steps for creating your first table, adding data to the table using the AWS SDK for Java, and monitoring the table in Amazon CloudWatch. For more information, see Getting Started.

23 March 2012

Updated Hive version to 0.7.1.3

Amazon Elastic MapReduce now supports a new version of Hive. For more information, see Exporting, Importing, Querying, and Joining Tables in Amazon DynamoDB Using Amazon EMR.

13 March 2012

New endpoint

Amazon DynamoDB expands to the Asia Pacific (Tokyo) Region. For the current list of supported endpoints, see Regions and Endpoints.

29 Feb 2012

Updated Hive version to 0.7.1.2

Amazon Elastic MapReduce now supports a new version of Hive. For more information, see Exporting, Importing, Querying, and Joining Tables in Amazon DynamoDB Using Amazon EMR.

28 Feb 2012

ReturnedItemCount metric added

A new metric, ReturnedItemCount, provides the number of items returned in the response of a Query or Scan operation for Amazon DynamoDB is available for monitoring through Amazon CloudWatch. For more information, see Monitoring Amazon DynamoDB Tables with Amazon CloudWatch.

24 Feb 2012

Added a code snippet for iterating over scan results

The AWS SDK for PHP returns scan results as a SimpleXMLElement object. For an example of how to iterate through the scan results, see Scanning Tables Using the AWS SDK for PHP Low-Level API.

2 Feb 2012

Added examples for incrementing values

Amazon DynamoDB supports incrementing and decrementing existing numeric values. Examples show adding to existing values in the "Updating an Item" sections at:

Working with Items Using the AWS SDK for Java Low-Level API.

Working with Items Using the AWS SDK for .NET Low-Level API.

Working with Items Using the AWS SDK for PHP Low-Level API.

25 Jan 2012

Initial product release

Amazon DynamoDB is introduced as a new service in Beta release.

18 Jan 2012