HomeWorkKeyspaces_frozencollections

Amazon Keyspaces - Improving table schema creation UX

Published Mar 2024
Updated Jun 2025
2 minutes read

Summary

Led the design of Frozen Collections feature for Amazon Keyspaces, enabling customers to create complex nested data structures in their Apache Cassandra workloads. This feature removed a major adoption blocker, with 42% of Cassandra customers previously unable to migrate due to missing Frozen Collections support.


Problem

Customer Pain Points

  1. Migration Blocker

    • 42% of Cassandra customers blocked from adopting Keyspaces
    • No support for nested collection data types
    • Unable to port existing schemas with frozen collections
  2. Schema Limitations

    • No way to create complex nested data structures
    • Missing support for collections as primary keys
    • Limited ability to protect collections from partial updates

Technical Context

What are Frozen Collections?

Frozen Collections in Cassandra are immutable collection types that:

Frozen Collections concept
Frozen Collections concept

Example Schema:

locations {
    country_id: map<text, frozen<map<text, frozen<list<text>>>>>
    // Represents: Country → State → Cities → Restaurants
}

Solution

1. Schema Creation Experience

Final table creation flow
Final table creation flow

2. Table Details Improvements

Table details page with frozen collections
Table details page with frozen collections
Table details page with frozen collections
Table details page with frozen collections

Key design decisions

Schema Editor Pattern

Three approaches were considered:

  1. Traditional Form-based Schema Creator
    • Pros: Familiar pattern, easier implementation
    • Cons: Not scalable for nested collections, complex validation
Traditional form-based schema creator
Traditional form-based schema creator
  1. Node-based Schema Editor
    • Pros: Better visualization of nesting, intuitive
    • Cons: Required new pattern approval, longer development time
Node-based schema editor
Node-based schema editor
  1. Hybrid Approach (Selected)
    • Form-based interface with hierarchical collection editor
    • Pros:
      • Combines familiarity of forms with visual hierarchy
      • Clear parent-child relationships for nested types
      • Progressive disclosure of complexity
      • Maintains existing interaction patterns
    • Cons:
      • Required careful UX consideration for deep nesting
      • More complex validation logic
Launched schema editor
Launched schema editor

Decision: Implemented the hybrid approach, using a form-based column designer with an embedded tree structure for nested collections. This provided an intuitive way to visualize and edit complex data structures while maintaining familiarity with existing patterns.

Key Implementation Details:


Challenges


Impact

Launch Results