NAME
Net::Amazon::DynamoDB::Lite - DynamoDB Client
SYNOPSIS
use Net::Amazon::DynamoDB::Lite;
my $dynamo = Amazon::DynamoDB::Lite->new(
region => 'ap-northeast-1',
access_key => 'XXXXX',
secret_key => 'YYYYY',
);
my $tables = $dynamo->list_tables;DESCRIPTION
Net::Amazon::DynamoDB::Lite is simple DynamoDB Client. It is really simple, fast, easy to use of the DynamoDB service.
THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.
METHODS
list_tables
Returns an arrayref of table names associated with the current account and endpoint.
Request Data
{ "ExclusiveStartTableName" => "string", "Limit" => "number" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_ListTables.html
put_item
Creates a new item, or replaces an old item with a new item.
Request Data
{ "ConditionExpression" => "string", "ConditionalOperator" => "string", "Expected" => { "string" => { "AttributeValueList": [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string", "Exists" => "boolean", "Value" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } }, "ExpressionAttributeNames" => { "string" => "string" }, "ExpressionAttributeValues" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "Item" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ReturnConsumedCapacity" => "string", "ReturnItemCollectionMetrics" => "string", "ReturnValues" => "string", "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_PutItem.html
get_item
Returns a set of attributes for the item with the given primary key.
Request Data
{ "AttributesToGet" => [ "string" ], "ConsistentRead" => "boolean", "ExpressionAttributeNames" => { "string" => "string" }, "Key" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ProjectionExpression" => "string", "ReturnConsumedCapacity" => "string", "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_GetItem.html
update_item
Edits an existing items attributes, or adds a new item to the table if it does not already exist.
Request Data
{ "AttributeUpdates" => { "string" => { "Action" => "string", "Value" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } }, "ConditionExpression" => "string", "ConditionalOperator" => "string", "Expected" => { "string" => { "AttributeValueList" => [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string", "Exists" => "boolean", "Value" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } }, "ExpressionAttributeNames" => { "string" => "string" }, "ExpressionAttributeValues" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "Key" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ReturnConsumedCapacity" => "string", "ReturnItemCollectionMetrics" => "string", "ReturnValues" => "string", "TableName" => "string", "UpdateExpression" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_UpdateItem.html
delete_item
Deletes a single item in a table by primary key.
Request Data
{ "ConditionExpression" => "string", "ConditionalOperator" => "string", "Expected" => { "string" => { "AttributeValueList" => [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string", "Exists" => "boolean", "Value" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } }, "ExpressionAttributeNames" => { "string" => "string" }, "ExpressionAttributeValues" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "Key" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ReturnConsumedCapacity" => "string", "ReturnItemCollectionMetrics" => "string", "ReturnValues" => "string", "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_DeleteItem.html
create_table
Adds a new table to your account.
Request Data
{ "AttributeDefinitions" => [ { "AttributeName" => "string", "AttributeType" => "string", } ], "GlobalSecondaryIndexes" => [ { "IndexName" => "string", "KeySchema" => [ { "AttributeName" => "string", "KeyType" => "string" } ], "Projection" => { "NonKeyAttributes" => [ "string" ], "ProjectionType" => "string" }, "ProvisionedThroughput" => { "ReadCapacityUnits" => "number", "WriteCapacityUnits" => "number" } } ], "KeySchema" => [ { "AttributeName" => "string", "KeyType" => "string" } ], "LocalSecondaryIndexes" => [ { "IndexName" => "string", "KeySchema" => [ { "AttributeName" => "string", "KeyType" => "string" } ], "Projection" => { "NonKeyAttributes" => [ "string" ], "ProjectionType" => "string" } } ], "ProvisionedThroughput" => { "ReadCapacityUnits" => "number", "WriteCapacityUnits" => "number" }, "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_CreateTable.html
delete_table
Deletes a table and all of its items.
Request Data
{ "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_DeleteTable.html
describe_table
Returns a information abount the table, including the current status of the table.
Request Data
{ "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_DescribeTable.html
update_table
Updates the provisioned throughput for the given table, or manages the global secondary indexes on the table.
Request Data
{ "AttributeDefinitions" => [ { "AttributeName" => "string", "AttributeType" => "string" } ], "GlobalSecondaryIndexUpdates" => [ { "Create" => { "IndexName" => "string", "KeySchema" => [ { "AttributeName" => "string", "KeyType" => "string" } ], "Projection" => { "NonKeyAttributes" => [ "string" ], "ProjectionType" => "string" }, "ProvisionedThroughput" => { "ReadCapacityUnits" => "number", "WriteCapacityUnits" => "number" } }, "Delete" => { "IndexName" => "string" }, "Update" => { "IndexName" => "string", "ProvisionedThroughput" => { "ReadCapacityUnits" => "number", "WriteCapacityUnits" => "number" } } } ], "ProvisionedThroughput" => { "ReadCapacityUnits" => "number", "WriteCapacityUnits" => "number" }, "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_UpdateTable.html
query
Uses the primary key of a table or a secondary index to directly access items from that table or index.
Request Data
{ "AttributesToGet" => [ "string" ], "ConditionalOperator" => "string", "ConsistentRead" => "boolean", "ExclusiveStartKey" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ExpressionAttributeNames" => { "string" => "string" }, "ExpressionAttributeValues" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "FilterExpression" => "string", "IndexName" => "string", "KeyConditionExpression" => "string", "KeyConditions" => { "string" => { "AttributeValueList" => [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string" } }, "Limit" => "number", "ProjectionExpression" => "string", "QueryFilter" => { "string" => { "AttributeValueList" => [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string" } }, "ReturnConsumedCapacity" => "string", "ScanIndexForward" => "boolean", "Select" => "string", "TableName" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_Query.html
scan
Returns one or more items and item attributes by accessing every item in a table or a secondary index.
Request Data
{ "AttributesToGet" => [ "string" ], "ConditionalOperator" => "string", "ExclusiveStartKey" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "ExpressionAttributeNames" => { "string" => "string" }, "ExpressionAttributeValues" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } }, "FilterExpression" => "string", "IndexName" => "string", "Limit" => "number", "ProjectionExpression" => "string", "ReturnConsumedCapacity" => "string", "ScanFilter" => { "string" => { "AttributeValueList" => [ { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } ], "ComparisonOperator" => "string" } }, "Segment" => "number", "Select" => "string", "TableName" => "string", "TotalSegments" => "number" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_Scan.html
batch_get_item
Returns the attributes of one or more items from one or more tables.
Requset Data
{ "RequestItems" => { "string" => { "AttributesToGet" => [ "string" ], "ConsistentRead" => "boolean", "ExpressionAttributeNames" => { "string" => "string" }, "Keys" => [ { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } ], "ProjectionExpression" => "string" } }, "ReturnConsumedCapacity" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_BatchGetItem.html
batch_write_item
Puts or Deletes multiple items in one or more tables.
Request Data
{ "RequestItems" => { "string" => [ { "DeleteRequest" => { "Key" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue } "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } }, "PutRequest" => { "Item" => { "string" => { "B" => "blob", "BOOL" => "boolean", "BS" => [ "blob" ], "L" => [ AttributeValue ], "M" => { "string" => AttributeValue }, "N" => "string", "NS" => [ "string" ], "NULL" => "boolean", "S" => "string", "SS" => [ "string" ] } } } } ] }, "ReturnConsumedCapacity" => "string", "ReturnItemCollectionMetrics" => "string" }SEE http://docs.aws.amazon.com/amazondynamodb/latest/APIReference//API_BatchWriteItem.html
LICENSE
Copyright (C) Kazuhiro Shibuya.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
AUTHOR
Kazuhiro Shibuya <stevenlabs at gmail.com>