Versões UUID Explicadas

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 usado 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 usado 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 usado 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 usado 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 usado 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-82da-3291d8c9fc1b

Vantagens

+Fully customizable
+Useful for embedding application-specific data

Desvantagens

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

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

Gerando 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

Guia de UUID: Versões, Formatos e Boas Práticas

UUID vs Outros Formatos de ID

ULID (Identificador Único Lexicograficamente Ordenável Universal)

ULIDs são uma alternativa compacta: timestamp de 48 bits + 80 bits aleatórios, codificados como 26 caracteres Crockford Base32. Eles são ordenáveis lexicograficamente por hora de criação.

Quando Usar IDs Auto-Incrementais

IDs sequenciais são mais simples e eficientes para aplicações com um único banco de dados. Use UUIDs quando você precisar de:

IDs gerados por múltiplos sistemas independentemente
IDs que não revelem a ordem de inserção para usuários externos
IDs compatíveis com merge para bancos de dados distribuídos

Considerações de Desempenho em Bancos de Dados

-- PostgreSQL: tipo UUID nativo (16 bytes, eficiente)
CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name TEXT NOT NULL
);

-- MySQL: armazene como BINARY(16) para desempenho
CREATE TABLE users (
  id BINARY(16) PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

FAQ

UUIDs podem ser usados como tokens de segurança?

UUID v4 usa 122 bits de aleatoriedade de uma fonte criptográfica, o que fornece boa entropia. No entanto, para tokens de segurança (chaves de API, IDs de sessão), é melhor usar formatos de token construídos para esse fim, com propriedades adicionais como checksums, codificação de expiração ou identificação por prefixo. UUIDs são para identidade, não para autenticação.

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ífens. São projetados para serem únicos no espaço e no tempo sem uma autoridade central.

Qual versão UUID devo usar?

Use v4 para a maioria dos propósitos gerais — é gerada aleatoriamente e tem probabilidade de colisão extremamente baixa. Use v7 se precisar de UUIDs ordenados por tempo para chaves primárias de banco de dados. Use 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. Isso 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 realmente únicos?

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

Ferramenta de Consulta de Endereço IP Guia Markdown com exemplos: copiar e colar Previsualizador Markdown Online — Editor ao Vivo Cheat Sheet de Regex — Referência Completa Testador de regex: expressões regulares online Referência de Códigos de Status HTTP

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Gerando 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

Guia de UUID: Versões, Formatos e Boas Práticas

UUID vs Outros Formatos de ID

ULID (Identificador Único Lexicograficamente Ordenável Universal)

ULIDs são uma alternativa compacta: timestamp de 48 bits + 80 bits aleatórios, codificados como 26 caracteres Crockford Base32. Eles são ordenáveis lexicograficamente por hora de criação.

Quando Usar IDs Auto-Incrementais

IDs sequenciais são mais simples e eficientes para aplicações com um único banco de dados. Use UUIDs quando você precisar de:

IDs gerados por múltiplos sistemas independentemente
IDs que não revelem a ordem de inserção para usuários externos
IDs compatíveis com merge para bancos de dados distribuídos

Considerações de Desempenho em Bancos de Dados

-- PostgreSQL: tipo UUID nativo (16 bytes, eficiente)
CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name TEXT NOT NULL
);

-- MySQL: armazene como BINARY(16) para desempenho
CREATE TABLE users (
  id BINARY(16) PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

FAQ

UUIDs podem ser usados como tokens de segurança?

FAQ de Versões UUID

O que é um UUID?

Qual versão UUID devo usar?

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

Os IDs UUID v4 são realmente únicos?

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

Versões UUID Explicadas

Estrutura UUID

Comparação Rápida

Gerando UUIDs em Código

Guia de UUID: Versões, Formatos e Boas Práticas

UUID vs Outros Formatos de ID

ULID (Identificador Único Lexicograficamente Ordenável Universal)

Quando Usar IDs Auto-Incrementais

Considerações de Desempenho em Bancos de Dados

FAQ

UUIDs podem ser usados como tokens de segurança?

FAQ de Versões UUID

O que é um UUID?

Qual versão UUID devo usar?

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

Os IDs UUID v4 são realmente únicos?

Ferramentas relacionadas

Versões UUID Explicadas

Estrutura UUID

Comparação Rápida

Gerando UUIDs em Código

Guia de UUID: Versões, Formatos e Boas Práticas

UUID vs Outros Formatos de ID

ULID (Identificador Único Lexicograficamente Ordenável Universal)

Quando Usar IDs Auto-Incrementais

Considerações de Desempenho em Bancos de Dados

FAQ

UUIDs podem ser usados como tokens de segurança?

FAQ de Versões UUID

O que é um UUID?

Qual versão UUID devo usar?

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

Os IDs UUID v4 são realmente únicos?

Ferramentas relacionadas