https://github.com/glassechidna/dynamo
Dead-simple AWS DynamoDB CLI
https://github.com/glassechidna/dynamo
aws aws-sdk-go cli dynamodb golang
Last synced: about 1 year ago
JSON representation
Dead-simple AWS DynamoDB CLI
- Host: GitHub
- URL: https://github.com/glassechidna/dynamo
- Owner: glassechidna
- License: mit
- Created: 2019-01-16T21:54:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-02-13T21:48:57.000Z (over 5 years ago)
- Last Synced: 2025-03-28T18:11:58.292Z (over 1 year ago)
- Topics: aws, aws-sdk-go, cli, dynamodb, golang
- Language: Go
- Size: 27.3 KB
- Stars: 10
- Watchers: 5
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `dynamo`
`dynamo` is a dead-simple CLI for AWS DynamoDB.
## Installation
* Mac: `brew install glassechidna/taps/dynamo`
* Windows: `scoop bucket add glassechidna https://github.com/glassechidna/scoop-bucket.git; scoop install dynamo`
* Otherwise get the latest build from the [Releases][releases] tab.
## Usage
```
dynamo [-n COUNT] [--dax CLUSTER] [table-name [partition key value [sort key value-or-expression]]]
```
* If no table name is specified, all tables are listed.
* If only a table name is specified, every row will be scanned.
* If a table name and partition key are provided, either:
* That item will be returned (for single-key schemas)
* All matching items will be returned (for partition+sort key schemas)
* If a table name, partition key and sort key are provided, only the matching
item will be returned.
In place of a constant sort key, you can also type:
* `> someval` - all items with sort key value greater than `someval`
* `>= someval` - as above, but "greater than or equal to"
* `<= someval` - as above, but "less than or equal to"
* `< someval` - as above, but "less than"
* `between val1 val2` - all items with sort keys between `val1` and `val2`
* `someval*` - all items with sort keys that begin with `someval`
By default, only **10** items will be returned -- this is to avoid accidentally
downloading an entire table! This can be controlled with the `-n 30` flag.
Passing `-n 0` disables the limit.
DynamoDB Accelerator (DAX) clusters are also supported. Pass `--dax cluster-name`
or `--dax cluster-address:port` to take advantage of this.
Finally, output is pretty-printed and colourised when executed directly. If
executed as part of a script (as determined by `isatty`), output will be
one-item-per-line in [JSON Lines][jsonlines] format.
[releases]: https://github.com/glassechidna/dynamo/releases
[jsonlines]: http://jsonlines.org/