UUID v4 oder v7: welche Version für Ihre Primärschlüssel

Beide haben 128 Bit und sehen gleich aus, enthalten aber Verschiedenes: v4 ist komplett zufällig, v7 beginnt mit dem Erstellungszeitpunkt. Dieser Unterschied entscheidet, wie sich Ihre Datenbankindizes verhalten und was jeder aus Ihren IDs ablesen kann.

Aktualisiert am

Der Bitaufbau von v4 und v7

Eine UUID ist eine 128-Bit-Zahl, geschrieben als 32 Hexadezimalziffern in Gruppen zu 8-4-4-4-12. RFC 9562 vom Mai 2024, der RFC 4122 abgelöst hat, definiert die beiden Versionen so (Bit 0 ist das linke):

Bits (Länge)v4v7
0–47 (48)ZufallUnix-Zeit (ms)
48–51 (4)Version 0100Version 0111
52–63 (12)ZufallZufall/Zähler
64–65 (2)Variante 10Variante 10
66–127 (62)ZufallZufall

v4 trägt also 122 Zufallsbits, v7 dagegen 48 Bit Zeit und 74 Bit für den Rest. In der Textform ist die erste Ziffer der dritten Gruppe die Version, und die erste Ziffer der vierten Gruppe ist immer 8, 9, a oder b, weil die beiden Variantenbits 10 lauten. Die Zeit einer v7 lässt sich direkt aus den ersten 12 Ziffern lesen:

01a1fbd4-f500-7c3a-9e21-5b8d40f1a6c7

0x01a1fbd4f500
= 1795226400000 ms
= 2026-11-21 02:00:00 UTC
= 21.11.2026 03:00 MEZ

Die Zahl ist ein Unix-Timestamp in Millisekunden; wie man ihn liest, erklärt die Anleitung zum Unix-Timestamp.

Warum v7 Datenbankindizes hilft

Primärschlüssel liegen meist in einem B-Baum-Index, der die Schlüssel sortiert hält. In InnoDB von MySQL werden sogar die Tabellenzeilen selbst in Reihenfolge des Primärschlüssels gespeichert. RFC 9562 benennt in Abschnitt 2.1 das Problem mit v4: Nacheinander erzeugte Werte liegen im Index nicht beieinander, jede neue Zeile landet also auf einer zufälligen Seite. Volle Seiten werden geteilt, halbleere Seiten vermehren sich, und der Teil des Index, der im Arbeitsspeicher bleiben muss, nähert sich dem ganzen Index.

Eine später erzeugte v7 ist immer größer als eine aus einer früheren Millisekunde, neue Zeilen kommen also an den rechten Rand des Index, wie bei einer Auto-Increment-Zahl. Der Unterschied: Die Anwendung kann die ID erzeugen, bevor sie mit der Datenbank spricht, etwa um sie in eine Warteschlange zu legen oder als Idempotenzschlüssel zu nutzen. Byte-Reihenfolge und Sortierung des kleingeschriebenen Hex-Textes stimmen überein, auch die Textform lässt sich also sortieren.

Innerhalb einer Millisekunde hängt die Reihenfolge von der Implementierung ab. RFC 9562 bietet in Abschnitt 6.2 drei Methoden an: einen Zähler hinter dem Zeitstempel, Zufallsdaten, die zugleich als Zähler dienen, oder zusätzliche Genauigkeit unterhalb der Millisekunde. Python nutzt einen 42-Bit-Zähler, PostgreSQL einen Bruchteil der Millisekunde, und laut Node.js-Dokumentation ist randomUUIDv7() nicht garantiert streng aufsteigend.

Kollisionsrisiko

Bei n UUIDs der Version 4 liegt die Wahrscheinlichkeit, dass zwei gleich sind, bei etwa n² ÷ (2 × 2122):

Anzahl v4-UUIDsRisiko einer Dublette
1 Million9,4 × 10−26
1 Milliarde9,4 × 10−20
1 Billion9,4 × 10−14
2,7 × 101850 %

Eine v7 kann nur mit einer anderen v7 aus derselben Millisekunde kollidieren. Mit 74 Zufallsbits ergeben 1.000 UUIDs pro Millisekunde aus getrennten Generatoren ein Risiko von etwa 2,6 × 10−17 pro Millisekunde, nach einem ganzen Jahr in diesem Tempo rund 8 × 10−7. Generatoren, die Bits für einen Zähler verwenden, haben weniger Zufallsbits, schließen dafür aber Kollisionen innerhalb desselben Generators aus. All das setzt voraus, dass die Zufallsbits aus einem kryptografisch sicheren Generator stammen, wie RFC 9562 in Abschnitt 6.9 empfiehlt. UUIDs aus Math.random erfüllen das nicht.

Wann Sie eine v7 nicht nach außen zeigen sollten

Wer eine v7 sieht, kann ihren Erstellungszeitpunkt auf die Millisekunde ablesen, wie im Beispiel oben. Bei Konto-, Bestell- oder Dokument-IDs in öffentlichen URLs verrät das, wann ein Konto eröffnet oder ein Kauf getätigt wurde. RFC 9562 nennt eingebettete Zeitstempel in Abschnitt 8 eine sehr kleine Angriffsfläche und ergänzt, dass UUIDs nicht als schwer zu erraten gelten und nicht als Berechtigungsnachweis dienen dürfen, also als Kennung, deren bloßer Besitz Zugriff gewährt. Eine sinnvolle Aufteilung: v7 als interner Primärschlüssel, v4 für die ID, die nach außen geht. Links zum Zurücksetzen von Passwörtern oder für Einladungen brauchen ein eigenes Zufallstoken, keine UUID.

UUIDs im Code erzeugen

JavaScript. Im Browser gibt es crypto.randomUUID() nur auf HTTPS-Seiten. Unter Node.js 14.17 bis 18 importieren Sie die Funktion aus node:crypto, weil das globale crypto erst ab Node.js 19 ohne Flag verfügbar ist.

// v4: Browser (HTTPS), Node.js 19+
crypto.randomUUID();

// v7: Node.js 24.16+ oder 26.1+
import { randomUUIDv7 }
  from 'node:crypto';
randomUUIDv7();

// v7 im Browser: npm-Paket uuid 10+
import { v7 } from 'uuid';
v7();

Python. uuid7() gibt es seit Python 3.14, und das Attribut time einer v7 enthält Unix-Millisekunden.

import uuid

uuid.uuid4()
uuid.uuid7()        # Python 3.14+
uuid.uuid7().time   # Unix-ms

PostgreSQL. Speichern Sie IDs in einer Spalte vom Typ uuid (16 Byte), nicht als Text mit 36 Zeichen. gen_random_uuid() gehört seit Version 13 zum Kern, uuidv7() seit Version 18. uuid_extract_timestamp() kam in Version 17 nur für v1, Version 18 ergänzte v7.

-- v4, ab PG 13
SELECT gen_random_uuid();
-- v7, ab PG 18
SELECT uuidv7();

CREATE TABLE orders (
  id uuid PRIMARY KEY
     DEFAULT uuidv7(),
  total numeric NOT NULL
);

-- Zeit aus v7 lesen, ab PG 18
SELECT uuid_extract_timestamp(id)
FROM orders;

UUIDs auf swift.id erzeugen und prüfen

  1. Öffnen Sie den UUID-Generator und Validator und wählen Sie Version 4 (zufällig) oder Version 7 (zeitlich sortiert).
  2. Tragen Sie die Anzahl (1-1000) ein und stellen Sie bei Bedarf das Format ein: Großbuchstaben, Ohne Bindestriche oder Geschweifte Klammern { }. Auch tausend v7-UUIDs auf einmal kommen sortiert heraus, weil das Tool einen 12-Bit-Zähler verwendet.
  3. Tippen Sie auf Kopieren oder Als .txt laden, oder auf Neu erzeugen, um alle zu ersetzen.
  4. Fügen Sie unter UUID analysieren eine beliebige UUID ein. Sie sehen Version und Variante und bei v1, v6 und v7 den Erstellungszeitpunkt, samt der Unix-Millisekunden, die Sie in Unix-Timestamp umrechnen nachprüfen können.

Häufige Fragen

Können v4 und v7 in derselben Spalte stehen?
Ja. Beide haben 128 Bit und dieselbe Variante, und eine Spalte vom Typ uuid nimmt jede Version an. Vorhandene Zeilen bleiben über den Index verstreut; nur neue Zeilen kommen in Reihenfolge hinzu.
Ist eine v7 leichter zu erraten als eine v4?
Teilweise: Die ersten 48 Bit lassen sich aus der Zeit abschätzen. Der Rest ist Zufall oder ein Zähler. RFC 9562 sagt, dass keine UUID als schwer zu erraten gelten soll; nutzen Sie sie also nie als Geheimnis.
Warum sind v7-UUIDs von zwei Servern nicht exakt sortiert?
Die Reihenfolge über mehrere Rechner ist nur so gut wie deren Uhren. Ein Server, dessen Uhr ein paar Millisekunden nachgeht, erzeugt UUIDs, die früher einsortiert werden. Innerhalb einer Millisekunde entscheiden bei zwei Generatoren die Zufallsbits.
Wie viel Platz braucht eine UUID in der Datenbank?
Der Typ uuid in PostgreSQL speichert 16 Byte. Als Text braucht die übliche Form mit 36 Zeichen mehr als doppelt so viel, und ihr Index wächst entsprechend.