NAME

Amazon::DynamoDB - support for the AWS DynamoDB API

VERSION

version 0.002

SYNOPSIS

my $ddb = Amazon::DynamoDB->new(
   implementation => 'Amazon::DynamoDB::LWP',
   version        => '20120810',
   access_key     => 'access_key',
   secret_key     => 'secret_key',
   host => 'dynamodb.us-east-1.amazonaws.com',
   scope => 'us-east-1/dynamodb/aws4_request',
   ssl => 1,
   debug => 1);

$ddb->batch_get_item(
   sub {
     my $tbl = shift;
     my $data = shift;
     print "Batch get: $tbl had " . join(',', %$data) . "\n";
   },
   RequestItems => {
     $table_name => { 
       Keys => [
         { 
           name => 'some test name here',
         }
       ],
       AttributesToGet => [qw(name age)],
     }
    })->get;

DESCRIPTION

Provides a Future-based API for Amazon's DynamoDB REST API. See Amazon::DynamoDB::20120810 for available methods.

Current implementations for issuing the HTTP requests:

• Amazon::DynamoDB::NaHTTP - use Net::Async::HTTP for applications based on IO::Async (this gives nonblocking behaviour)

• Amazon::DynamoDB::LWP - use LWP::UserAgent (will block, timeouts are unlikely to work)

• Amazon::DynamoDB::MojoUA - use Mojo::UserAgent, should be suitable for integration into a Mojolicious application. (not well tested)

METHODS

SEE ALSO

• Net::Amazon::DynamoDB - supports the older (2011) API with v2 signing, so it doesn't work with DynamoDB Local.

• AWS::CLIWrapper - alternative approach using wrappers around AWS commandline tools

• WebService::Amazon::DynamoDB - this module was based off of this initial code.

IMPLEMENTATION PHILOSOPHY

This module attempts to stick as close to Amazon's API as possible while making some inconvenient limits easy to work with.

Parameters are named the same, return values are as described. Documentation for each method is commonly found at:

http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Operations.html

For examples see the test cases, most functionality is well exercised via tests.

AUTHOR

Rusty Conover <rusty@luckydinosaur.com>

Based on code by:

Tom Molesworth <cpan@entitymodel.com>

LICENSE

Copyright 2014 Lucky Dinosaur, LLC. Licensed under the same terms as Perl itself. Copyright Tom Molesworth 2013. Licensed under the same terms as Perl itself.