Gerador de UUID (v4, v7, ULID, NanoID)

UUID v4 ou UUID v7: qual usar?

Um UUID é um identificador de 128 bits escrito como 32 dígitos hexadecimais em cinco grupos, como 3f2c8a1e-5b7d-4e9f-a0c1-2d3e4f5a6b7c. Seis desses bits são fixos: quatro indicam a versão (o primeiro dígito do terceiro grupo) e dois indicam a variante (o primeiro dígito do quarto grupo é 8, 9, a ou b em UUIDs padrão).

A versão 4 preenche os outros 122 bits com dados aleatórios. É o padrão em quase todo lugar, não revela nada sobre quando ou onde foi criado, e a chance de dois colidirem é desprezível: você precisaria gerar cerca de um bilhão por segundo durante 85 anos para chegar a 50% de chance de uma única duplicata.

A versão 7, padronizada na RFC 9562 em 2024, coloca um timestamp Unix de 48 bits em milissegundos no início e preenche o resto com bits aleatórios. Novos IDs v7 ficam, portanto, em ordem de criação, o que mantém compactos os índices B-tree do banco: as inserções vão para o fim do índice em vez de páginas aleatórias, e esse é o principal motivo de usuários de Postgres, MySQL e SQL Server estarem trocando chaves primárias de v4 para v7. A contrapartida é que qualquer um com o ID pode ler quando ele foi criado. Este gerador mantém os IDs v7 estritamente crescentes mesmo dentro do mesmo milissegundo, usando o contador de 12 bits que a RFC descreve.

ULID e NanoID

Use ULID quando quiser ordenação por tempo em uma string mais curta e sem diferenciar maiúsculas; use NanoID para IDs públicos, como links curtos ou códigos de convite, em que o tamanho importa e a ordenação por tempo não.

ULID

26 caracteres em base32 de Crockford, como 01JAZ1S83VV6F35M4HSN97TA7X: um timestamp de 48 bits em milissegundos seguido de 80 bits aleatórios. Ordena lexicamente por tempo, evita as letras parecidas I, L, O e U e cabe nos mesmos 128 bits de um UUID, então pode ser guardado em uma coluna uuid. O modo monotônico incrementa a parte aleatória para IDs criados no mesmo milissegundo.

NanoID

Uma string aleatória compacta, por padrão 21 caracteres de A–Z, a–z, 0–9, _ e -, o que dá cerca de 126 bits de aleatoriedade: tão resistente a colisões quanto o UUID v4 em menos caracteres, e seguro em URLs e nomes de arquivo sem codificação.

Alfabetos personalizados

O NanoID pode usar só dígitos, só minúsculas, alfanuméricos, um alfabeto sem caracteres parecidos ou qualquer conjunto que você digitar. A ferramenta mostra os bits de aleatoriedade resultantes para você escolher um tamanho que continue seguro.

GUID, chaves e outros formatos

GUID é o nome que a Microsoft dá à mesma coisa que um UUID. O .NET, o registro do Windows e o COM costumam mostrá-lo em MAIÚSCULAS entre chaves, como {3F2C8A1E-5B7D-4E9F-A0C1-2D3E4F5A6B7C}, que é o que a opção de chaves produz. Alguns sistemas querem os 32 dígitos sem hifens; outros os guardam em uma coluna binary(16). Tudo isso são os mesmos 128 bits.

Os formatos entre aspas adicionam as vírgulas para você, então mil IDs podem ir direto para WHERE id IN (…) ou para um array JSON. Para linhas realistas em vez de IDs soltos, o Gerador de Dados de Teste monta tabelas inteiras com colunas UUID.

Lendo um UUID existente

O inspetor aceita um UUID com ou sem hifens, chaves, aspas ou o prefixo urn:uuid:, e um ULID em maiúsculas ou minúsculas. Ele diz se o valor está bem formado, que versão e variante declara e, para as versões baseadas em tempo 1, 6 e 7 e para ULIDs, o momento de criação embutido como data ISO 8601 no seu fuso horário e em UTC.

As versões 3 e 5 são hashes de um namespace e um nome (MD5 e SHA-1), então a mesma entrada sempre dá o mesmo UUID e não há tempo para ler. A versão 8 é reservada para layouts personalizados. O nil UUID (só zeros) e o max UUID (só uns) são valores especiais definidos pela RFC.