AWS DynamoDB support

[GromNaN]

Like S3, DynamoDB is one of the core services of AWS. It's a serverless document database. It would be great to have it in this library.

Documentation: https://docs.aws.amazon.com/aws-sdk-php/v2/guide/service-dynamodb.html

There is a few methods to implement:

• BatchGetItem
• BatchWriteItem
• CreateTable
• DeleteItem
• DeleteTable
• DescribeTable
• GetItem
• ListTables
• PutItem
• Query
• Scan
• UpdateItem
• UpdateTable

Generic use-cases:

• Session handler https://docs.aws.amazon.com/aws-sdk-php/v2/guide/feature-dynamodb-session-handler.html
• Distributed lock https://aws.amazon.com/blogs/database/building-distributed-locks-with-the-dynamodb-lock-client/
• Sémaphore https://boylesoftware.com/blog/convenient-semaphore-dynamodb/
• Others https://docs.aws.amazon.com/aws-sdk-php/v2/guide/service-dynamodb.html

[Nyholm]

I agree!

Do you mind creating a PR?
Have a look here for how to generate these classes: https://github.com/async-aws/aws/blob/master/docs/maintainer-notes.md#creating-a-new-client-operation

[Nyholm]

Most of DynamoDb is implemented. The batch methods require some more work on the CodeGenerator.

Im going to leave this for a while, but Im happy to review PRs.

[GromNaN]

I've tried to translate the official documentation of aws-php-sdk with your implementation.

State of operations testing:

• BatchGetItem
• BatchWriteItem
• CreateTable
• DeleteItem
• DeleteTable
• DescribeTable
• GetItem
• ListTables
• PutItem
• Query
• Scan
• UpdateItem
• UpdateTable

The current result is here: https://gist.github.com/GromNaN/1e7a651871fd1ac174d02254bf9b3fe3

• I'm missing the waitUntil function for Waiters, this is useful for the S3 client too.
• I get an error 400 when I try to get an item, without any error message.
• (edited) getPath function on result looks useful.

[jderusse]

Thanks for your tests.
I've opened #332 to provides TableExists waiter.

$client->tableExists(['TableName' => 'errors'])->wait();

AttributeValue::$N (and AWS) expect to be string, you should use

'time'    => array('N' => (string) $time),

I know the error could have been Improved => #333

later, use echo $result->getItem()['id']->getN() . "\n"; instead of ['id']['N']

Beware getConsumedCapacity returns an object

echo "Consumed capacity; " . ($result->getConsumedCapacity() ? $result->getConsumedCapacity()->getCapacityUnits() : null) . "\n";

[GromNaN]

Thank you for the review.
I've update the gist. Everything works, including #333.
I've also added a waiter for delete table #338.

[Nyholm]

Everything? Ie all but two #302 (comment)?

[jderusse]

Hat's the status of this issue? Shall we release Batch methods? Do we have a use-case?

[GromNaN]

We can release as this, the main features are implemented.

[Nyholm]

I tagged 0.1.0 of async-aws/dynamo-db

[jderusse]

Closing this issue. Let open a new one if we have a specific use-case for remaining operations