UUIDv7

Hvert storh-post-id er en UUIDv7: et tidsstempel på 48 bit i millisekunder efterfulgt af tilfældig entropi, formateret som en standard-UUID på 36 tegn. Da tidsstemplet står først, sorteres id'er efter oprettelsestid, og den ene egenskab understøtter det meste af storh: markørbaseret sideinddeling (after($id)), læsning af tidsintervaller, overspringning af segmenter i loggen og stabil sortering overalt.

$id = Storh\UuidV7::generate();

Storh\UuidV7::is_valid($id);          // bool, accepts upper and lower case
Storh\UuidV7::assert_valid($id);      // throws StorageException instead
$timestampMs = Storh\UuidV7::timestamp_ms($id);

Genereringen er monoton inden for en proces: id'er, der oprettes i samme millisekund, øger den foregående entropi i stedet for at generere den igen, så hurtige skrivebølger stadig sorteres efter oprettelsesrækkefølge.

Tidsbaseret opslag

For tidsintervaller udleder storh den mindste og største mulige UUIDv7 for et tidsstempel i millisekunder og sammenligner id'er med disse grænser:

$query = Storh\RecordQuery::all()->time_range_ms(
    1_700_000_000_000,
    1_700_000_060_000,
);

$lower = Storh\UuidV7::min_for_timestamp_ms(1_700_000_000_000);
$upper = Storh\UuidV7::max_for_timestamp_ms(1_700_000_060_000);

Derfor kræver læsning af tidsintervaller ikke et tidsstempelfelt i postdataene: id'et indeholder oprettelsestidspunktet.

Angivelse af egne id'er

Alle motorer accepterer et eksplicit id ved hver skrivning ($docs->put($data, $id)) og en id_generator i deres konstruktører. Id'er fra begge veje valideres som UUIDv7, så brugerdefinerede generatorer skal producere dem; deterministiske generatorer gør det muligt for testsuiten at oprette reproducerbare fixtures. UuidV7::reset_for_tests() nulstiller den monotone tilstand på procesniveau mellem testtilfælde.