NAME

Amazon::DynamoDB - API support for Amazon DynamoDB

VERSION

version 0.35

SYNOPSIS

  my $ddb = Amazon::DynamoDB->new(
     implementation => 'Amazon::DynamoDB::LWP',
     version        => '20120810',

     access_key     => 'access_key',
     secret_key     => 'secret_key',
     # or you specify to use an IAM role
     use_iam_role   => 1, 

     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)

NAME

Amazon::DynamoDB - support for the AWS DynamoDB API

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.

AUTHORS

• Rusty Conover <rusty@luckydinosaur.com>

• Tom Molesworth <cpan@entitymodel.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Tom Molesworth, copyright (c) 2014 Lucky Dinosaur LLC. http://www.luckydinosaur.com.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.