Versions UUID Expliquées

Chaque version UUID — v1 à v8 — avec diagrammes de structure, cas d'usage, risque de collision et exemples de code JavaScript.

Structure UUID

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

time_low (32 bits)time_mid (16 bits)M = version (4 bits) + time_hi (12)N = variant (2 bits) + clock (14)node / random (48 bits)

UUID v1Time-based (MAC)Sortable

Structure

timestamp (60-bit) + clock seq (14-bit) + MAC (48-bit)

Risque de collision

Very low

6ba7b810-9dad-11d1-80b4-00c04fd430c8

Avantages

+Globally unique
+Sortable by time
+Embeds creation time

Inconvénients

−Exposes MAC address (privacy risk)
−Requires MAC or pseudo-random node
−Clock adjustments can cause duplicates

Meilleur usage

Legacy systems. Avoid in new projects due to MAC address exposure.

UUID v3Name-based (MD5)Not sortable

Structure

MD5(namespace UUID + name) → UUID

Risque de collision

MD5 collision risk (low for UUIDs)

6fa459ea-ee8a-3ca4-894e-db77e160355e

Avantages

+Deterministic — same input = same UUID
+Can recreate UUIDs from known inputs

Inconvénients

−MD5 is cryptographically weak
−Not random — attackers can predict given namespace+name
−Prefer v5 for new projects

Meilleur usage

Generating UUIDs from URLs, email addresses, or other stable identifiers. Use v5 instead.

UUID v4RandomNot sortable

Structure

122 random bits + 4-bit version + 2-bit variant

Risque de collision

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

Avantages

+Extremely low collision probability
+No timestamp/MAC leakage
+Simple generation — no state needed
+Most widely supported

Inconvénients

−Not sortable by generation time
−Random order degrades B-tree performance in databases
−Cannot verify when a UUID was created

Meilleur usage

Default choice for most applications. IDs for records, sessions, tokens.

UUID v5Name-based (SHA-1)Not sortable

Structure

SHA-1(namespace UUID + name) → UUID (top 128 bits)

Risque de collision

SHA-1 — extremely low for UUID purposes

886313e1-3b8a-5372-9b90-0c9aee199e5d

Avantages

+Deterministic like v3, but uses SHA-1
+Stronger hash than MD5 (v3)
+Standard namespaces: DNS, URL, OID, X.500

Inconvénients

−SHA-1 is fully deterministic — not suitable for secrets
−Truncates SHA-1 to 128 bits

Meilleur usage

Deterministic IDs from a namespace + name. Example: UUID for 'https://example.com' is always the same.

UUID v7Time-ordered RandomSortable

Structure

Unix ms timestamp (48-bit) + version (4-bit) + random (74-bit)

Risque de collision

Very low (74 random bits)

018f0b2d-4c9e-7abc-89de-f012345678ab

Avantages

+Sortable by time (great for database primary keys)
+Does NOT expose MAC address
+Near-zero collision probability
+RFC 9562 standard

Inconvénients

−Slightly less entropy than v4 (74 vs 122 bits)
−Requires a time source
−Newer — less library support than v4

Meilleur usage

Database primary keys where sort order matters. Replaces v1 for time-ordered UUIDs.

UUID v8CustomSortable

Structure

128 bits, content defined by the implementation

Risque de collision

Depends on implementation

2489e9ad-f195-8b67-72da-3291d8c9fc1b

Avantages

+Fully customizable
+Useful for embedding application-specific data

Inconvénients

−No standard semantics — interoperability must be documented
−Not widely supported

Meilleur usage

Experimental or vendor-specific use cases where v1–v7 don't fit.

Comparaison Rapide

Version	Method	Sortable	Privacy-safe	Deterministic
v1	Time + MAC	✅	❌ (MAC leak)	❌
v3	MD5 hash	❌	✅	✅
v4	Random	❌	✅	❌
v5	SHA-1 hash	❌	✅	✅
v7	Time + Random	✅	✅	❌
v8	Custom	—	—	—

Générer des UUIDs dans le Code

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

FAQ des Versions UUID

Qu'est-ce qu'un UUID ?

Un UUID (Universally Unique Identifier) est un identifiant de 128 bits standardisé dans RFC 4122. Il est formaté en 8-4-4-4-12 caractères hexadécimaux séparés par des tirets. Ils sont conçus pour être uniques dans l'espace et le temps sans autorité centrale.

Quelle version UUID devrais-je utiliser ?

Utilisez v4 pour la plupart des usages généraux — elle est générée aléatoirement et a une probabilité de collision extrêmement faible. Utilisez v7 si vous avez besoin d'UUIDs ordonnés par temps pour les clés primaires de base de données. Utilisez v5 pour des UUIDs déterministes à partir d'une paire namespace+nom.

Quelle est la différence entre UUID v4 et v7 ?

UUID v4 est purement aléatoire (122 bits aléatoires). UUID v7 encode un timestamp Unix dans les 48 premiers bits suivi de bits aléatoires. Cela rend les UUIDs v7 triables par date de création, améliorant significativement les performances d'index B-tree.

Les IDs UUID v4 sont-ils vraiment uniques ?

Pratiquement oui. UUID v4 a 122 bits aléatoires, donnant 2^122 ≈ 5,3 × 10^36 valeurs possibles. Pour avoir 50% de chance de collision, il faudrait générer environ 2,7 × 10^18 UUIDs.

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Générer des UUIDs dans le Code

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

FAQ des Versions UUID

Qu'est-ce qu'un UUID ?

Quelle version UUID devrais-je utiliser ?

Quelle est la différence entre UUID v4 et v7 ?

Les IDs UUID v4 sont-ils vraiment uniques ?

Pratiquement oui. UUID v4 a 122 bits aléatoires, donnant 2^122 ≈ 5,3 × 10^36 valeurs possibles. Pour avoir 50% de chance de collision, il faudrait générer environ 2,7 × 10^18 UUIDs.

Versions UUID Expliquées

Structure UUID

Comparaison Rapide

Générer des UUIDs dans le Code

FAQ des Versions UUID

References & cheat sheets

Versions UUID Expliquées

Structure UUID

Comparaison Rapide

Générer des UUIDs dans le Code

FAQ des Versions UUID