Module metadata 

SuperTable Metadata

This module defines the core metadata structures for SuperTable, a next-generation open table format. The design is inspired by Apache Iceberg’s metadata specification while adding modern enhancements for better concurrency control and auditability.

Key Concepts

• TableMetadata: The root metadata object containing all table state
• Snapshot: An immutable point-in-time view of a table
• Schema: The table’s column definitions with evolution support
• PartitionSpec: How the table is partitioned (planned)

Concurrency Model

SuperTable uses optimistic concurrency control (OCC) with compare-and-swap (CAS) semantics. Each metadata update increments the last_sequence_number, enabling conflict detection during concurrent writes.

Structs

SnapshotLogEntry

A log entry recording a snapshot change.

TableMetadata

The root metadata object for a SuperTable table.

TableMetadataBuilder

Builder for constructing TableMetadata instances.

TableMetrics

Aggregate metrics for a table.

Enums

MetadataError

Errors that can occur during metadata operations.

Constants

FORMAT_VERSION

The format version of SuperTable metadata. Increment this when making breaking changes to the metadata format.