Cassandra SSTable Format Parsing

Parse Cassandra 5.0+ SSTable components to inspect binary formats and offsets.

17|5|Updated Jul 14, 2025
One-click install
npx skills add https://github.com/pmcfadin/cqlite --skill cassandra-sstable-format-parsing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Cassandra SSTable Format Parsing
Source: https://github.com/pmcfadin/cqlite/tree/main/.claude/skills/sstable-parsing
Command: npx skills add https://github.com/pmcfadin/cqlite --skill cassandra-sstable-format-parsing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers parse and understand Cassandra 5.0+ SSTable components (Data.db, Index.db, Statistics.db, Summary.db, TOC), including compression, BTI indexing, and offset calculations. It aids debugging, troubleshooting, and data-recovery tasks involving raw SSTable files.

Core Features & Use Cases

  • Parse and inspect Data.db, Index.db, Statistics.db, Summary.db, and TOC components.
  • Debug binary formats, examine hex dumps, and verify block boundaries across compression algorithms.
  • Understand BTI (Big Table Index) mappings and partition boundary layouts for robust data access.

Quick Start

Point this Skill at a local Cassandra SSTable (e.g., Data.db) and use the built-in references to explore format details. Use the accompanying reference notes to interpret flag bytes, VInt encodings, and compression blocks.

Frequently Asked Questions about Cassandra SSTable Format Parsing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parse Cassandra SSTable files to debug data issues?

Parse Cassandra 5.0+ SSTable files by pointing this Skill at Data.db, Index.db, Statistics.db, Summary.db, and TOC components. Extract binary format details, inspect partition layouts, validate offsets, and diagnose compression or BTI indexing problems using zero-copy deserialization and built-in format references.

What compression formats does Cassandra SSTable parsing support?

SSTable parsing supports LZ4, Snappy, and Deflate compression formats. The Skill handles block boundary verification, decompression validation, and format-specific offset calculations across all three algorithms to identify compression-related data corruption or misalignment.

Can I use SSTable parsing to recover corrupted Cassandra data?

Yes. By parsing SSTable binary formats, inspecting hex dumps, validating partition boundaries, and analyzing BTI mappings, you can diagnose data corruption, locate offset errors, and identify which components are affected—enabling targeted recovery strategies.

How do I interpret BTI indexing and partition boundaries in SSTables?

Use the Skill's reference notes to decode BTI (Big Table Index) mappings and partition layout structure. Understand flag bytes, VInt encodings, and delta-encoded metadata handling to verify correct partition boundaries and block offsets within Data.db and Index.db.

What's the difference between SSTable components—Data.db, Index.db, Statistics.db, Summary.db, and TOC?

Data.db stores partition rows; Index.db maps row keys to offsets; Statistics.db holds column metadata; Summary.db provides partition index summaries; TOC tracks file format version and component checksums. Parsing each reveals structure integrity and cross-component consistency.