NAME

Amazon::DynamoDB - API support for Amazon DynamoDB

VERSION

version 0.08

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)

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.

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.

AUTHOR

Rusty Conover <rusty@luckydinosaur.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Rusty Conover.

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

cpanm Amazon::DynamoDB

perl -MCPAN -e shell
install Amazon::DynamoDB