Versioni UUID Spiegate

Ogni versione UUID — da v1 a v8 — con diagrammi di struttura, casi d'uso, rischio di collisione ed esempi di codice JavaScript.

Struttura 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

Struttura

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

Rischio di collisione

Very low

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

Vantaggi

+Globally unique
+Sortable by time
+Embeds creation time

Svantaggi

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

Meglio utilizzato per

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

UUID v3Name-based (MD5)Not sortable

Struttura

MD5(namespace UUID + name) → UUID

Rischio di collisione

MD5 collision risk (low for UUIDs)

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

Vantaggi

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

Svantaggi

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

Meglio utilizzato per

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

UUID v4RandomNot sortable

Struttura

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

Rischio di collisione

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

Vantaggi

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

Svantaggi

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

Meglio utilizzato per

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

UUID v5Name-based (SHA-1)Not sortable

Struttura

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

Rischio di collisione

SHA-1 — extremely low for UUID purposes

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

Vantaggi

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

Svantaggi

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

Meglio utilizzato per

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

UUID v7Time-ordered RandomSortable

Struttura

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

Rischio di collisione

Very low (74 random bits)

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

Vantaggi

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

Svantaggi

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

Meglio utilizzato per

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

UUID v8CustomSortable

Struttura

128 bits, content defined by the implementation

Rischio di collisione

Depends on implementation

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

Vantaggi

+Fully customizable
+Useful for embedding application-specific data

Svantaggi

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

Meglio utilizzato per

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

Confronto Rapido

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	—	—	—

Generare UUID nel Codice

// 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 Versioni UUID

Cos'è un UUID?

Un UUID (Universally Unique Identifier) è un identificatore a 128 bit standardizzato in RFC 4122. È formattato come 8-4-4-4-12 caratteri esadecimali separati da trattini. Sono progettati per essere unici nello spazio e nel tempo senza un'autorità centrale.

Quale versione UUID dovrei usare?

Usa v4 per la maggior parte degli scopi generali — è generata casualmente e ha una probabilità di collisione estremamente bassa. Usa v7 se hai bisogno di UUID ordinati per tempo per chiavi primarie di database. Usa v5 per UUID deterministici da una coppia namespace+nome.

Qual è la differenza tra UUID v4 e v7?

UUID v4 è puramente casuale (122 bit casuali). UUID v7 codifica un timestamp Unix nei primi 48 bit seguito da bit casuali. Questo rende gli UUID v7 ordinabili per tempo di creazione, migliorando significativamente le prestazioni dell'indice B-tree.

Gli ID UUID v4 sono veramente unici?

Praticamente sì. UUID v4 ha 122 bit casuali, dando 2^122 ≈ 5,3 × 10^36 valori possibili. Per avere il 50% di probabilità di collisione occorrerebbe generare circa 2,7 × 10^18 UUID.

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Generare UUID nel Codice

// 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 Versioni UUID

Cos'è un UUID?

Quale versione UUID dovrei usare?

Qual è la differenza tra UUID v4 e v7?

Gli ID UUID v4 sono veramente unici?

Praticamente sì. UUID v4 ha 122 bit casuali, dando 2^122 ≈ 5,3 × 10^36 valori possibili. Per avere il 50% di probabilità di collisione occorrerebbe generare circa 2,7 × 10^18 UUID.

Versioni UUID Spiegate

Struttura UUID

Confronto Rapido

Generare UUID nel Codice

FAQ Versioni UUID

References & cheat sheets

Versioni UUID Spiegate

Struttura UUID

Confronto Rapido

Generare UUID nel Codice

FAQ Versioni UUID