DynamoDBToLiteDB 0.0.5

DynamoDbToLiteDb

A small CLI tool to turn a DynamoDB backup into a local LiteDB file—and optionally CSV—so you can query or export data without incurring large scan costs.

Why use this

• Lower cost: Downloading a backup from S3 avoids DynamoDB scans and high read-capacity consumption.
• Local querying: Inspect or filter data in LiteDB without hitting AWS.
• CSV export: Extract only the fields you need for reports or sharing.

Prerequisites

• Export your DynamoDB table to an S3 bucket
• Copy the S3 path to manifest-summary.json (or download that file locally)
• AWS credentials/configured with S3 “GetObject” access on your machine

Installation

dotnet tool install -g DynamoDbToLiteDb

# Or build locally
git clone https://github.com/your-org/dynamoDbToLiteDb.git
cd dynamoDbToLiteDb
dotnet pack
dotnet tool install --global --add-source ./nupkg DynamoDBToLiteDB

Usage

dynamoDbToLiteDb [command] [options]

Import backup into LiteDB

dynamoDbToLiteDb <manifest-summary> [options]

• <manifest-summary> — local path or S3 URL to manifest-summary.json

Export CSV from LiteDB

dynamoDbToLiteDb tocsv <fields...> [options]

• <fields...> — space-separated field names to include in CSV

Options

Examples

1. Import S3 backup

   dynamoDbToLiteDb s3://my-bucket/backups/manifest-summary.json \
     --output data/app.db \
     --backup-path ./tmp \
     --clean
   

2. Export selected fields

   dynamoDbToLiteDb tocsv UserId Name Email \
     --db data/app.db \
     --output users.csv \
     --where "IsActive=true"
   

Contributing

1. Fork the repo
2. Create a branch (git checkout -b my-change)
3. Commit & push
4. Open a pull request

License

MIT