Versões UUID Explicadas

Cada versão UUID — v1 a v8 — com diagramas de estrutura, casos de utilização, risco de colisão e exemplos de código JavaScript.

Estrutura 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

Estrutura

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

Risco de colisão

Very low

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

Vantagens

+Globally unique
+Sortable by time
+Embeds creation time

Desvantagens

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

Melhor utilizado para

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

UUID v3Name-based (MD5)Not sortable

Estrutura

MD5(namespace UUID + name) → UUID

Risco de colisão

MD5 collision risk (low for UUIDs)

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

Vantagens

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

Desvantagens

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

Melhor utilizado para

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

UUID v4RandomNot sortable

Estrutura

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

Risco de colisão

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

Vantagens

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

Desvantagens

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

Melhor utilizado para

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

UUID v5Name-based (SHA-1)Not sortable

Estrutura

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

Risco de colisão

SHA-1 — extremely low for UUID purposes

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

Vantagens

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

Desvantagens

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

Melhor utilizado para

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

UUID v7Time-ordered RandomSortable

Estrutura

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

Risco de colisão

Very low (74 random bits)

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

Vantagens

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

Desvantagens

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

Melhor utilizado para

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

UUID v8CustomSortable

Estrutura

128 bits, content defined by the implementation

Risco de colisão

Depends on implementation

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

Vantagens

+Fully customizable
+Useful for embedding application-specific data

Desvantagens

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

Melhor utilizado para

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

Comparação Rápida

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

Gerar UUIDs em Código

// 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 de Versões UUID

O que é um UUID?

Um UUID (Universally Unique Identifier) é um identificador de 128 bits padronizado no RFC 4122. É formatado como 8-4-4-4-12 caracteres hexadecimais separados por hífenes. São concebidos para serem únicos no espaço e no tempo sem uma autoridade central.

Qual versão UUID devo utilizar?

Utilize v4 para a maioria dos propósitos gerais — é gerada aleatoriamente e tem probabilidade de colisão extremamente baixa. Utilize v7 se precisar de UUIDs ordenados por tempo para chaves primárias de base de dados. Utilize v5 para UUIDs determinísticos de um par namespace+nome.

Qual é a diferença entre UUID v4 e v7?

UUID v4 é puramente aleatória (122 bits aleatórios). UUID v7 codifica um timestamp Unix nos primeiros 48 bits seguido de bits aleatórios. Isto torna os UUIDs v7 ordenáveis por tempo de criação, melhorando significativamente o desempenho do índice B-tree.

Os IDs UUID v4 são verdadeiramente únicos?

Praticamente sim. UUID v4 tem 122 bits aleatórios, dando 2^122 ≈ 5,3 × 10^36 valores possíveis. Para ter 50% de probabilidade de colisão seria necessário gerar cerca de 2,7 × 10^18 UUIDs.

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Gerar UUIDs em Código

// 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 de Versões UUID

O que é um UUID?

Qual versão UUID devo utilizar?

Qual é a diferença entre UUID v4 e v7?

Os IDs UUID v4 são verdadeiramente únicos?

Praticamente sim. UUID v4 tem 122 bits aleatórios, dando 2^122 ≈ 5,3 × 10^36 valores possíveis. Para ter 50% de probabilidade de colisão seria necessário gerar cerca de 2,7 × 10^18 UUIDs.

Versões UUID Explicadas

Estrutura UUID

Comparação Rápida

Gerar UUIDs em Código

FAQ de Versões UUID

References & cheat sheets

Versões UUID Explicadas

Estrutura UUID

Comparação Rápida

Gerar UUIDs em Código

FAQ de Versões UUID