DynamoDB Viewer

A modern, responsive AWS DynamoDB viewer and editor for VS Code.

Features

• Browse and explore your AWS DynamoDB tables directly within VS Code
• View, edit, add, and delete table items with a responsive interface
• Import and export JSON data
• Simplified table name display (optional)
• Filter tables by hash prefix
• Support for multiple AWS profiles
• Clear table data functionality

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "DynamoDB Viewer"
4. Click Install

Getting Started

Prerequisites

• AWS credentials configured in your ~/.aws/credentials file
• Proper IAM permissions to access DynamoDB tables

Basic Usage

1. Click on the DynamoDB Explorer icon in the Activity Bar
2. View your DynamoDB tables in the explorer view
3. Click on a table to open its data in the editor

Features in Detail

AWS Profile Selection

DynamoDB Viewer supports multiple AWS profiles:

1. Click the profile icon (👤) in the DynamoDB Explorer title bar
2. Select your desired AWS profile from the dropdown list
3. The extension will automatically switch to the selected profile and display the tables available under that profile

Each profile maintains its own set of tables and settings, making it easy to work with multiple AWS environments.

Filtering Tables

If you have many tables, you can filter them by hash prefix:

1. Click the filter icon (🔍) in the DynamoDB Explorer title bar
2. Enter the first few characters of the table hash prefix
3. The explorer will show only matching tables

To clear the filter, click the filter icon again and remove the text.

Table Name Simplification

When working with tables that follow naming patterns like TableName-hash-NONE, the extension can simplify display names:

1. Apply a hash filter
2. Table names will automatically display in simplified form
3. Toggle this feature in settings (dynamoViewer.simplifyTableNames)

Exploring Table Data

Click on any table to open its data view:

• View all items in a table with a responsive grid layout
• Sort columns by clicking on column headers
• Resize columns for better visibility of data

Editing Items

1. Click the edit icon (✏️) next to any item
2. Modify the JSON data in the editor
3. Click "Save Changes" to update the item in DynamoDB

Adding New Items

1. Click the "Add New" button in the table view
2. Enter JSON data for the new item (required key attributes will be pre-populated)
3. Click "Add Item" to save to DynamoDB

Deleting Items

1. Click the delete icon (🗑️) next to any item
2. Confirm the deletion in the dialog
3. The item will be removed from the DynamoDB table

Importing Data

1. Click the "Import" button in the table view
2. Select a JSON file containing an array of items
3. The items will be imported into the DynamoDB table

Clearing Table Data

To clear all data from a table:

1. Right-click on a table in the explorer
2. Select "Clear Table" from the context menu
3. Confirm the action

To clear data from all tables:

1. Click the trash icon (🗑️) in the DynamoDB Explorer title bar
2. Confirm the action

Extension Settings

This extension contributes the following settings:

• dynamoViewer.hashFilter: Hash prefix filter for table names
• dynamoViewer.simplifyTableNames: Simplify table names (remove hash and NONE)
• dynamoViewer.awsProfile: AWS profile to use for DynamoDB access

Known Issues

• Performance may be affected when working with very large tables
• Scan operations have a 1MB response size limit per request

Release Notes

0.0.8

• Added support for multiple AWS profiles
• Improved table list loading performance
• Added ability to clear table data
• Fixed various UI issues

0.0.7

• Added table name simplification
• Improved error handling
• Added hash prefix filtering

0.0.6

• Initial release
• Basic table viewing and editing functionality

Feedback and Contributions

• File issues and feature requests on GitHub
• Pull requests welcome

License

This extension is licensed under the MIT License.

Enjoy exploring your DynamoDB data!