{"id":16578056,"url":"https://github.com/glynnbird/dynamodbexport","last_synced_at":"2025-10-07T00:09:37.992Z","repository":{"id":57217872,"uuid":"84421618","full_name":"glynnbird/dynamodbexport","owner":"glynnbird","description":"DynamoDB export command-line script.","archived":false,"fork":false,"pushed_at":"2017-08-15T14:06:03.000Z","size":6,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-25T12:31:36.899Z","etag":null,"topics":["command-line","dynamodb","export","json"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glynnbird.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-09T09:10:58.000Z","updated_at":"2022-03-08T15:45:14.000Z","dependencies_parsed_at":"2022-08-28T21:40:39.021Z","dependency_job_id":null,"html_url":"https://github.com/glynnbird/dynamodbexport","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glynnbird%2Fdynamodbexport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glynnbird%2Fdynamodbexport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glynnbird%2Fdynamodbexport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glynnbird%2Fdynamodbexport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glynnbird","download_url":"https://codeload.github.com/glynnbird/dynamodbexport/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238777004,"owners_count":19528812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-line","dynamodb","export","json"],"created_at":"2024-10-11T22:13:00.545Z","updated_at":"2025-10-07T00:09:32.945Z","avatar_url":"https://github.com/glynnbird.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dynamodbexport\n\nCommand-line utility to export a DynamoDB database to a list of JSON documents.\n\n## Installation\n\nThe *dynamodbexport* package is installed via npm:\n\n```sh\nnpm install -g dynamodbexport\n```\n\nYou may need to precede the above command with `sudo`, depending on your Node.js installation.\n\n## Configuration\n\nThe *dynamodbexport* command-line tool assumes a [locally installed copy of DynamoDB](http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) by default. If you want to use hosted DynamoDB, then\nsupply your AWS key and secret key as environment variables:\n\n```sh\nexport AWS_ACCESS_KEY_ID=\"OGIIWJGNWNIITJHWTHSO\"\nexport AWS_SECRET_ACCESS_KEY=\"YRPHIIIWJJJYwKLGV28JJuiuwnjiiqq06ASn\"\n```\n\nThe AWS *Region* must also be set with the `-r` or `--region` command-line parameter.\n\n## Command-line Usage\n\nUse the *dynamodbexport* tool to export an entire DynamoDB table. The table is specified with the `-t` or `--table` command-line parameter:\n\n```sh\n$ dynamodbexport -t mytable -r us-east-1\n{\"temperature\":8391,\"time\":\"2017-03-09T01:38:11+0000\",\"id\":\"1489023491\"}\n{\"temperature\":29130,\"time\":\"2017-03-09T02:35:37+0000\",\"id\":\"1489026937\"}\n{\"temperature\":27650,\"time\":\"2017-03-08T18:35:58+0000\",\"id\":\"1488998158\"}\nExport complete { iterations: 1, records: 3, time: 0.145 }\n```\n\nThe data can be directed to a text file:\n\n```sh\n$ dynamodbexport -t mytable \u003e mydata.txt\nExport complete { iterations: 1, records: 3, time: 0.145 }\n```\n\nor piped elsewhere e.g. to [couchimport](https://www.npmjs.com/couchimport) to import the data into Apache CouchDB:\n\n```sh\n$ dynamodbexport --table mytable | couchimport --db mycouchtable --type jsonl\nExport complete { iterations: 1, records: 3, time: 0.145 }\ncouchimport writecomplete { total: 3, totalfailed: 0 } +20ms\ncouchimport Import complete\n```\n\n## Programmatic Usage\n\nYou can also use the library within your own code:\n\n```js\nvar dynamodbexport = require('dynamodbexport');\nvar region = 'us-east-1';\nvar table = 'mytable';\ndynamodbexport.tableExport(region, table, function(err, data) {\n  if (err) {\n    console.error('ERROR', err)\n  } else {\n    console.error('Export complete', data)\n  }\n});\n```\n\n## Options Reference\n\n### Command-line parameters\n\n* -t or --table - the table to export (required)\n* -r or --region - the AWS region to communicate with (for remote DynamoDB exports only)\n\n### Environment variables\n\n* AWS_ACCESS_KEY_ID - the AWS key\n* AWS_SECRET_ACCESS_KEY - the AWS secret\n\nN.B The *role* attached to the credentials you supply must have `DynamoDB.Scan` privileges.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglynnbird%2Fdynamodbexport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglynnbird%2Fdynamodbexport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglynnbird%2Fdynamodbexport/lists"}