Skip to main content

A toolchain for AWS DynamoDB to make common operations (backup, restore backups) easier.

Project description

A toolchain for Amazon’s DynamoDB to make common operations (backup, restore backups) easier. Currently contains:

  • dynamodb-dumper - backup tables out of DynamoDB with ease.

  • dynamodb-loader - restore tables dumped by dynamodb-dumper with ease.

All tools are built to work with both the main DynamoDB service and DynamoDB Local so you can test them out, and also move data easily between production and your test environment, or between Dynamo regions.

Install with:

pip install dynamodb_utils

Usage Examples

You can get the (hopefully detailed enough) help with e.g.:

dynamodb-dumper --help

To dump a table, with compression:

dynamodb-dumper mytable.name --compress

To dump just a few hash-key values from a table (for example, if you want a restricted subset of data for development):

dynamodb-dumper mytable.name --compress --hash-keys 101 104 404

To load some compressed dump files on a DynamoDB Local instance running locally on port 3232:

dynamodb-loader mytable.name --host http://localhost:3232 --region localhost --load mytable.name.*.dump.gz

The tools are based upon PynamoDB, which is based upon botocore. Therefore, credentials will be read from one of many places - IAM Role, environment variables, or a ‘boto file’. See the boto documentation for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dynamodb_utils-1.0.0.tar.gz (4.7 kB view hashes)

Uploaded Source

Built Distributions

dynamodb_utils-1.0.0-py3-none-any.whl (7.6 kB view hashes)

Uploaded Python 3

dynamodb_utils-1.0.0-py2-none-any.whl (7.6 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page