Expand description
SST file inspector binary for turbo-persistence databases.
This tool inspects SST files to report entry type statistics per family, useful for verifying that inline value optimization is being used.
Entry types:
- 0: Small value (stored in value block)
- 1: Blob reference
- 2: Deleted/tombstone
- 3: Medium value
- 8-255: Inline value where (type - 8) = value byte count
Structsยง
- Block
Size ๐Info - Block size information
- RawBlock ๐
- Information about a raw block read from disk.
- SstInfo ๐
- Information about an SST file from the meta file
- SstStats ๐
- Statistics for a single SST file
Enumsยง
- KeyBlock
Header ๐ - Parsed header of a key block.
Constantsยง
- KEY_
BLOCK_ ๐HEADER_ SIZE - Size of the key block header (1B type + 3B entry count).
Functionsยง
- analyze_
sst_ ๐file - Analyze an SST file and return entry type statistics
- collect_
sst_ ๐info - Collect SST info from all meta files in the database directory
- entry_
type_ ๐description - family_
name ๐ - format_
bytes ๐ - format_
number ๐ - Format a number with comma separators for readability
- iter_
key_ ๐block_ entry_ types - Iterates over entry type bytes in a key block.
- main ๐
- parse_
key_ ๐block_ header - Parses the header of a key block from the full decompressed block data.
- parse_
key_ ๐block_ indices - Parses an index block to extract all referenced key block indices.
- print_
block_ ๐stats - print_
entry_ ๐histogram - print_
family_ ๐summary - print_
sst_ ๐details - print_
value_ ๐storage - read_
block ๐ - Reads, checksums, and decompresses a single block from the mmap.
- track_
entry_ ๐type - Accumulates statistics for a single entry of the given type.