sdbport is in maintenance mode!

We will continue to provide best effort support for bug fix requests, however new features will not be added.

Sdbport exports & imports data from AWS SimpleDB domains. It can be used as a class or stand alone CLI.

gem install sdbport

Set your AWS credentials:

export AWS_ACCESS_KEY_ID=your_aws_key
export AWS_SECRET_ACCESS_KEY=your_aws_secret

Export SimpleDB domain sample from us-west-1:

sdbport export -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n sample -o /tmp/dump.sdbport

To export larger SimpleDB domains, add -w. This writes each chunk to file as it is received rather than storing in memory:

sdbport export -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n sample -o /tmp/dump.sdbport -w

Import into domain sample in us-east-1:

sdbport import -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-east-1 -n sample -i /tmp/dump.sdbport

You can specify your credentials on the command line, however it is best to add them to a configuration file.

By default, sdbport look for .sdbport.yml in your home directory. To get started, create the file ~/.sdbport.yml:

default:
  access_key: your_aws_key
  secret_key: your_aws_secert

You can add multiple account credentials and specify the account as a CLI option with --account (-a).

prod:
  access_key: your_aws_key
  secret_key: your_aws_secert
preprod:
  access_key: your_aws_key
  secret_key: your_aws_secert

Export SimpleDB domain sample from prod account in us-west-1:

sdbport export -a prod -r us-west-1 -n sample -o /tmp/dump.sdbport

Import into domain sample in preprod account in us-east-1:

sdbport import -a preprod -r us-east-1 -n sample -i /tmp/dump.sdbport

To list CLI subcommands:

sdbport -h

For details help on specific subcommand:

sdbport export -h

• Only supports importing into empty domain.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request