NAME

Net::Amazon::DynamoDB::Table - Higher level interface to Net::Amazon::DyamoDB::Lite

SYNOPSIS

use Net::Amazon::DynamoDB::Table;

my $table = Net::Amazon::DynamoDB::Table->new(
    region      => 'us-east-1',  # required
    table       => $table,       # required
    hash_key    => 'planet',     # required
    range_key   => 'species',    # required if table has a range key
    access_key  => ...,          # default: $ENV{AWS_ACCESS_KEY};
    secret_key  => ...,          # default: $ENV{AWS_SECRET_KEY};
);

# create or update an item
$table->put(Item => { planet => 'Mars', ... });

# get the item with the specified primary key; returns a hashref
my $item = $table->get(planet => 'Mars');

# delete the item with the specified primary key
$table->delete(planet => 'Mars');

# scan the table for items; returns an arrayref of items
my $items_arrayref = $table->scan();

# scan the table for items; returns items as a hash of key value pairs
my $items_hashref = $table->scan_as_hashref();

DESCRIPTION

A Net::Amazon::DynamoDB::Table object represents a single table in DynamoDB. This module provides a simple UI layer on top of Net::Amazon::DynamoDB::Lite.

There are two features which make this class "simpler" than Net::Amazon::DynamoDB::Lite.

The first is that you don't need to specify the TableName in every call.

The second is that you don't need to worry about types.

METHODS

new()

Returns a Net::Amazon::DynamoDB::Table object. Accepts the following attributes:

    region      => 'us-east-1',  # required
    table       => $table,       # required
    hash_key    => $hash_key,    # required
    range_key   => $range_key,   # required if table has a range key
    access_key  => ...,          # default: $ENV{AWS_ACCESS_KEY};
    secret_key  => ...,          # default: $ENV{AWS_SECRET_KEY};

put()

Creates a new item, or replaces an old item with a new item. This method accepts the same parameters as those accepted by the AWS DynamoDB put_item api endpoint. Note however, that you don't need to specify any types. This module does that for you. For example:

$dynamodb->put((
    Item => {
        a => 1,                  # a Number
        b => "boop",             # a String
        c => [ "hi mom", 23.5 ], # a List composed of a String and Number
        d => {                   # a Map
            chipmunks       => [qw/alvin theodore/], # a List of Strings
            backstreet_boys => [qw/Nick Kevin/],     # a List of Strings
            thing           => 23,                   # a Number
        },
    },
);

get()

Returns a hashref representing the item specified by the given primary key. You can specify the primary key using the HashKey and RangeKey parameters provided for convenience by this module:

my $item = $dynamodb->get(
    planet  => 'Mars',
    species => 'green aliens',
);

Or you can explicitly specify the primary key and types using the Key parameter like this:

my $item = $dynamodb->get(
    Key => [ 
        { planet  => { S => 'Mars'         } },
        { species => { N => 'green aliens' } },
    ],
);

This method also accepts the same parameters as those accepted by the AWS DynamoDB get_item api endpoint. For example:

my $item = $dynamodb->get(
    planet         => 'Mars',
    species        => 'green aliens',
    ConsistentRead => 1,
);

delete()

Deletes a single item from a table using the given primary key. You can specify the primary key using the HashKey and RangeKey parameters provided for convenience by this module:

my $item = $dynamodb->delete(
    planet  => 'Mars',
    species => 'green aliens',
);

Or you can explicitly specify the primary key and types using the Key parameter like this:

my $item = $dynamodb->get(
    Key => [ 
        { planet  => { S => 'Mars'         } },
        { species => { N => 'green aliens' } },
    ],
);

This method also accepts the same parameters as those accepted by the AWS DynamoDB get_item api endpoint. For example:

my $item = $dynamodb->get(
    planet                    => 'Mars',
    species                   => 'green aliens',
    ConditionExpression       => "planet := :p",
    ExpressionAttributeValues => { ':p' => { S => 'Mars' } },
);

scan()

This method accepts the same parameters as those accepted by the AWS DynamoDB scan api endpoint. It returns an arrayref of item hashrefs.

scan_as_hashref()

This method accepts the same parameters as those accepted by the AWS DynamoDB scan api endpoint. It returns the results as a hashref that looks like this:

# { $hash_key_value1 => $item1,
#   $hash_key_value2 => $item2, 
#   ...,
# }

ACKNOWLEDGEMENTS

Thanks to DuckDuckGo for making this module possible.

LICENSE

Copyright (C) Eric Johnson.

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

AUTHOR

Eric Johnson <eric.git@iijo.org>

cpanm Net::Amazon::DynamoDB::Table

perl -MCPAN -e shell
install Net::Amazon::DynamoDB::Table