Enum HotCandidateInspection 

pub enum HotCandidateInspection {
    Hit(Row),
    MissingRow,
    Invisible,
    Tombstone,
    TtlExpired,
    PrimaryKeyMismatch {
        materialized_pk: Vec<u8>,
        requested: Vec<u8>,
    },
}

Diagnostic classification of a HOT (Hash-Organized Table) candidate row.

Table::get collapses several distinct failure modes into None (tombstone, TTL expiry, snapshot invisibility). To preserve observability across every HOT fallback path, [Table::resolve_pk_with_hot_fallback] inspects the candidate directly and tags the failure with one of these reasons before delegating to the PK equality scanner.

PrimaryKeyMismatch carries the mismatched bytes for diagnostics — the materialized_pk is the value read from the row’s PK column and requested is the lookup key bytes (after HMAC tokenization). Neither is used as the authoritative result; the fallback scanner is the only source of the returned row set.

Variants

Hit(Row)

Mapped RowId materialized, is visible, live, TTL-valid, and carries the requested PK. The branch may return this row without a fallback.

MissingRow

Row does not exist at the mapped RowId — overlay and all runs returned no version. The base row was removed entirely.

Invisible

Row exists but is stamped with a (committed_epoch, commit_ts) that the calling Snapshot does not observe. Distinct from a tombstone: the row may still be visible at a later snapshot.

Tombstone

The newest visible row at the mapped RowId is a tombstone (deleted = true). A replacement row with the same PK may exist elsewhere — the scanner is responsible for finding it.

TtlExpired

The newest visible row exists and is not deleted, but the row’s TTL metadata says the row expired at the calling wall clock. Distinct from Tombstone: the row is still durable, just hidden by TTL.

PrimaryKeyMismatch

Row materialized with valid visibility/TTL, but its materialized PK does not match the requested PK bytes. The HOT map is stale and must not return this row — only the scanner’s verified result is returned.

Fields

materialized_pk: Vec<u8>

PK bytes encoded from the materialized row’s PK column.

requested: Vec<u8>

PK bytes that the caller requested (post-HMAC tokenization).

Trait Implementations

impl Clone for HotCandidateInspection

fn clone(&self) -> HotCandidateInspection

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HotCandidateInspection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for HotCandidateInspection

fn eq(&self, other: &HotCandidateInspection) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HotCandidateInspection