Transform DynamoDB results with JavaScript in Terminal
Prerequisite: Download Dynobase (free to try) in order to follow the steps below
Dynobase Terminal runs a JavaScript transform over the rows loaded in the current tab. Its result grid is read-only, but explicit calls through the supplied database helper can write to DynamoDB immediately. Review scripts before running them against a live table.
1
Load data and open Terminal
Run the query or scan you need, check whether results are complete, then open Terminal from the table workspace.
2
Write a transform
Define transform(data) and return an array of rows. Use filter, map, or reduce for local transformations; the db helper and table key helpers are available for explicit database operations.
3
Run and inspect results
Click Run or press Cmd+Enter on macOS or Ctrl+Enter on Windows/Linux in the editor. Inspect the returned rows and any error; transformed results do not become pending grid edits.
Frequently Asked Questions
When is Terminal useful?
Use it for transformations that do not fit a DynamoDB filter expression, such as regular-expression checks or aggregations over loaded rows. It only receives fetched data, so an incomplete scan cannot produce a table-wide total.
What are example use cases?
Validate loaded records, map attributes for inspection, or calculate statistics from the loaded dataset. Async scripts can also call external APIs or the database helper; explicit database writes execute when the script runs.
How does transform(data) work?
The function receives the loaded item array and returns an array for display, either directly or through a Promise. Helpers include
db, TableName, and keyOf(record) for the current table.Can I write asynchronous code?
Yes. Terminal accepts Promises and async/await. Handle errors in scripts that make several writes, because a partially completed script is not automatically rolled back.
Can I export a script to run outside Dynobase?
Yes, Terminal can export a Node.js script. In 3.0.8 that exporter still emits AWS SDK for JavaScript v2 code, which is out of support; migrate it to SDK v3 and review pagination before using it in automation.
Product Features
DynamoDB Tools
- SSH GUI Client
- Chat With Cloud
- MongoDB GUI Client
- AWS Cost Monitoring
- DynamoDB Query Builder
- DynamoDB Code Examples
- DynamoDB Node.js Queries
- DynamoDB JSON Converter
- DynamoDB UUID Generator
- DynamoDB Local Admin GUI
- DynamoDB Pricing Calculator
- DynamoDB Single-Table Design
- Best DynamoDB GUI Clients
- Dynobase vs DynoTable
DynamoDB Info
© 2026 Dynobase