UUID
Generator

O UUID v4 é o cavalo de batalha. 122 bits aleatórios mais 6 bits fixos de versão/variante, gerados a partir de um RNG criptograficamente seguro. A probabilidade de colisão é tão baixa (seria preciso gerar ~1 mil milhão de UUIDs por segundo durante ~85 anos para ter 50 % de hipóteses de colisão) que pode ser tratada como zero à escala da internet. Use-o como default para quase tudo.

O UUID v1 codifica um timestamp de 60 bits, um endereço MAC e uma sequência de relógio. É ordenável por tempo de criação mas expõe o MAC da máquina e o instante exato de criação, o que é uma preocupação de privacidade. A maioria dos sistemas modernos evita o v1 por essa fuga e porque a ordenação por timestamp fica desconfortável (os bits baixos vêm primeiro).

O UUID v7 (RFC 9562, 2024) é a alternativa moderna ao v1: timestamp Unix em milissegundos de 48 bits nos bits altos, seguido de bits aleatórios. É lexicograficamente ordenável, o que o torna drasticamente melhor para chaves primárias em B-tree do que o v4 (que fragmenta o índice porque as inserções ficam dispersas). Use o v7 em desenhos novos de base de dados onde quer UUIDs e boa localidade de índice.

O UUID NIL (00000000-0000-0000-0000-000000000000) é uma sentinela que significa 'sem valor' — útil como default em colunas FK opcionais ou como placeholder em testes. O UUID Max (ffffffff-ffff-ffff-ffff-ffffffffffff) é a sentinela equivalente como teto, usada em consultas de intervalo.

ToolSeo.uuid-generator.section1.p5

Os inteiros auto-incrementais (BIGSERIAL em Postgres, AUTO_INCREMENT em MySQL) são pequenos (8 bytes), amigos da cache e produzem índices B-tree densos. A desvantagem é que expõem informação de negócio — qualquer pessoa que veja order=4217 consegue inferir o volume de encomendas — e tornam escritas multi-master complicadas, porque o servidor de base de dados tem de coordenar o próximo valor.

Os UUIDs têm 16 bytes (2× o custo de armazenamento e índice de um BIGINT), não expõem contagens, podem ser gerados no cliente sem ida ao servidor e sobrevivem a workflows offline-first onde os IDs têm de existir antes de a linha chegar ao servidor. São também seguros para URLs e globalmente únicos entre shards, serviços e bases de dados.

A stack pragmática: UUID v7 como chave primária (boa localidade de índice, sem fuga de contagens, gerável no cliente), uma coluna opcional BIGINT order_number amigável para humanos para mostrar no UI, e um public_id opaco e opcional (Nano ID ou hash curto) para URLs que precisam de ficar bonitos.

Não use UUID v4 como chave primária numa tabela grande e ativa sem pensar bem — a aleatoriedade causa amplificação de escrita severa nos índices B-tree. Use UUID v7, ou então BIGINT como chave primária com uma coluna UUID separada para referências externas.

ToolSeo.uuid-generator.section2.p5

Um UUID é, no fundo, 16 bytes. Guardado como binary(16) ou tipo uuid do Postgres, custa 16 bytes por linha. Guardado como a string canónica com hífenes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx), custa 36 bytes mais o overhead por linha — mais do dobro do custo binário.

Em Postgres, use sempre o tipo nativo uuid — guarda em binário internamente, aceita entrada/saída em string de forma transparente e suporta indexação e ordenação corretamente. O MySQL não tem tipo UUID nativo; use BINARY(16) com as funções auxiliares UUID_TO_BIN e BIN_TO_UUID, opcionalmente com a flag de rearranjo para um armazenamento mais amigável para o índice.

Em APIs, devolva a forma de string com hífenes. É o formato universal de troca. Base64 e Base58 produzem strings mais curtas (22 e 22 caracteres respetivamente contra 36) mas partem o ferramenteiro — debuggers, greps a logs e clientes SQL esperam todos a forma com hífenes. Reserve as formas codificadas curtas só para slugs de URL.

ToolSeo.uuid-generator.section3.p4

ToolSeo.uuid-generator.section3.p5

ToolSeo.uuid-generator.section4.p1

ToolSeo.uuid-generator.section4.p2

ToolSeo.uuid-generator.section4.p3

ToolSeo.uuid-generator.section4.p4

ToolSeo.uuid-generator.section4.p5

ToolSeo.uuid-generator.section5.p1

ToolSeo.uuid-generator.section5.p2

ToolSeo.uuid-generator.section5.p3

ToolSeo.uuid-generator.section5.p4

ToolSeo.uuid-generator.section5.p5