Firebridge DynamoDB Explorer for VS Code

Browse, query, inspect, and edit DynamoDB tables without leaving VS Code.

This extension is designed for everyday DynamoDB work: opening tables quickly, exploring PK/SK data shapes, running targeted queries, inspecting records in multiple formats, editing data, and generating sample datasets for testing.

Quick Links

1. Website: https://www.firebridge.app/vscode-dynamodb
2. Documentation: https://www.firebridge.app/documentation/dynamodb

Why Use It

Instead of bouncing between the AWS Console, ad hoc scripts, and JSON dumps, you can work with DynamoDB directly in one place.

Use it to:

1. Browse AWS and local DynamoDB tables from a left-side explorer.
2. Open tables in an interactive grid with staged editing.
3. Query by PK/SK visually or run PartiQL directly.
4. Inspect results in Grid, Tree, or JSON views.
5. Explore PK/SK folder groupings for hierarchical-style sort keys.
6. Export results and generate SDK code.
7. Generate demo data for testing and demos.

Core Capabilities

Explorer for AWS and Local DynamoDB

The explorer supports:

1. AWS profiles and regions
2. AWS SSO login flow
3. Local DynamoDB connections
4. Table, index, record, and attribute nodes
5. Table actions such as open, delete, and metrics
6. Record actions such as open in grid, open in JSON, delete, and copy primary key

Query Builder and PartiQL

You can query data using either:

1. Query Builder for visual rule-based queries
2. PartiQL for direct statement execution

Query Builder includes:

1. PK and SK helper buttons
2. Index selection
3. AND/OR and grouped conditions
4. Query-vs-scan behavior guidance
5. Sort direction controls for queryable sort keys

Grid, Tree, and JSON Views

After opening a table, results can be inspected as:

1. Grid for editing and scanning many rows
2. Tree for nested record browsing
3. JSON for raw record structure

Tree mode also supports a PK/SK tree view when the loaded data includes both key attributes.

Editing and Data Operations

The webview supports:

1. Inline cell edits
2. Insert new rows
3. Delete rows
4. Undo staged changes
5. Save staged changes
6. Create table
7. Delete table

Export and Code Generation

Export the current result set as:

1. JSON
2. CSV

Generate code samples for:

1. TypeScript
2. JavaScript
3. Python
4. Go
5. Java
6. C#

Demo Data Generation

Generate ready-to-use sample datasets directly from the explorer.

Available scenarios include:

1. ecommerce
2. iot
3. social
4. hierarchical
5. simple

This is useful for demos, local testing, and validating PK/SK browsing behavior.

Getting Started

Credential setup first:

1. AWS profile: run aws configure.
2. AWS SSO: run aws configure sso, then aws sso login --profile your-profile-name.
3. Local DynamoDB only: set firebridge-dynamodb-explorer.localEndpoint and firebridge-dynamodb-explorer.localRegion.

How to get your-profile-name:

1. Run aws configure list-profiles and pick the profile you set up.

2. Or open your AWS config file and use the name after profile in a header like [profile dev-account].

3. If you use the default profile, the name is default.

4. Install the extension.

5. Open the Firebridge DynamoDB activity bar view.

6. Expand an AWS profile and region, or Local DynamoDB.

7. Open a table.

8. Use Query Builder to add a PK rule and run your first query.

Local DynamoDB Support

For local development, configure:

1. firebridge-dynamodb-explorer.localEndpoint
2. firebridge-dynamodb-explorer.localRegion

Then expand Local DynamoDB in the explorer.

Configuration Highlights

Useful settings:

1. firebridge-dynamodb-explorer.localEndpoint
2. firebridge-dynamodb-explorer.localRegion
3. firebridge-dynamodb-explorer.explorerPreviewLimit
4. firebridge-dynamodb-explorer.explorerGroupingMode
5. firebridge-dynamodb-explorer.awsSsoStartUrl

Explorer grouping mode supports:

1. auto
2. grouped
3. flat

Who This Is For

This extension is useful if you:

1. Work with single-table DynamoDB designs
2. Need to inspect PK/SK-heavy datasets quickly
3. Want to query DynamoDB without constantly writing scripts
4. Need local DynamoDB support during development
5. Want a faster inspection/editing workflow inside VS Code

Documentation

For a full task-based guide, see the user manual in the repository.

Telemetry

This extension uses VS Code extension telemetry for anonymous usage and reliability events.

Notes:

1. No table payloads or item values are collected.
2. Telemetry follows VS Code telemetry settings.

Release Notes

1.0.0

Initial release of Firebridge DynamoDB Explorer.

• Browse AWS and Local DynamoDB tables.
• Visual Query Builder and PartiQL editor.
• Grid, Tree, and JSON views.
• Inline editing and staged changes.
• Demo data generation.
• Export to JSON and CSV.
• AWS SSO support.