UUIDv7

Jokainen storh-tietueen tunniste on UUIDv7: 48-bittinen millisekuntiaikaleima, jota seuraa satunnainen entropia ja joka on muotoiltu tavalliseksi 36 merkin UUID-tunnisteeksi. Koska aikaleima on alussa, tunnisteet järjestyvät luontiajan mukaan, ja tämä ominaisuus mahdollistaa useimmat storh-toiminnot: kursorisivutuksen (after($id)), aikaväliluvut, segmenttien ohituksen lokissa ja vakaan järjestyksen kaikkialla.

$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);

Luonti on prosessin sisällä monotonista: samalla millisekunnilla luodut tunnisteet kasvattavat edellistä entropia-arvoa sen sijaan, että arvo arvottaisiin uudelleen, joten nopeat kirjoituspiikit säilyvät luontijärjestyksessä.

Aikakohdistus

Aikaikkunoita varten storh johtaa pienimmän ja suurimman mahdollisen UUIDv7-arvon millisekuntiaikaleimalle ja vertaa tunnisteita näihin rajoihin:

$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);

Siksi aikaväliluvuissa ei tarvita aikaleimakenttää tietueen tiedoissa: tunniste sisältää luontiajan.

Omien tunnisteiden käyttäminen

Kaikki moottorit hyväksyvät kirjoituskohtaisen tunnisteen ($docs->put($data, $id)) ja id_generator-kutsuttavan konstruktorissaan. Kummastakin lähteestä tulevat tunnisteet validoidaan UUIDv7-tunnisteiksi, joten omien generaattorien on tuotettava niitä; determinististen generaattorien avulla testisarja luo toistettavia testitietoja. UuidV7::reset_for_tests() tyhjentää prosessitason monotonisen tilan testitapausten välillä.