Gerador de UUID

Um UUID (identificador único universal, chamado de GUID nos softwares da Microsoft) é um número de 128 bits escrito como 32 dígitos hexadecimais em grupos de 8-4-4-4-12, por exemplo f47ac10b-58cc-4372-a567-0e02b2c3d479. Ele foi padronizado na RFC 4122, em 2005; em maio de 2024 esse documento foi substituído pela RFC 9562, que mantém as versões antigas e acrescenta três novas. Duas posições são fixas: o primeiro dígito do terceiro grupo é a versão (o 4 em 4372), e o primeiro dígito do quarto grupo indica a variante, que é 8, 9, a ou b em todo UUID que segue a RFC.

A versão 4 preenche os outros 122 bits com dados aleatórios. Esse espaço é tão grande que seria preciso gerar cerca de 2,7 quintilhões (2,7 × 10¹⁸) deles para ter 50% de chance de um único duplicado, e por isso os sistemas criam IDs v4 de forma independente em várias máquinas, sem coordenação. Esta página usa crypto.randomUUID, ou crypto.getRandomValues quando ele não existe, e nunca Math.random, cuja saída não foi feita para ser imprevisível. As opções Maiúsculas e Sem hifens mudam apenas a formatação; o valor é o mesmo, e a maioria dos analisadores aceita as duas formas.

As versões 1 e 6 são construídas a partir de um carimbo de data e hora e de um ID de nó, originalmente o endereço MAC do computador, o que revela onde e quando o ID foi criado. As versões 3 e 5 geram um hash de um namespace e de um nome com MD5 ou SHA-1, então a mesma entrada sempre produz o mesmo UUID. A versão 8 é um formato livre para esquemas personalizados. A novidade mais importante é a versão 7: ela começa com um carimbo de tempo Unix de 48 bits em milissegundos e preenche o resto com bits aleatórios, de modo que os IDs se ordenam pela data de criação.

Essa ordenação é o motivo para considerar a v7 em chaves primárias de bancos de dados. Chaves v4 aleatórias caem em pontos espalhados do índice B-tree, dividindo páginas e prejudicando a localidade de cache conforme a tabela cresce, enquanto as chaves v7 chegam em ordem aproximadamente crescente, como uma coluna de autoincremento, mas ainda podem ser geradas sem um contador central. Escolha a v4 quando quiser um ID que não revele nada, nem mesmo quando foi criado; escolha a v7 quando o desempenho de inserção e a ordenação por tempo importarem. Um UUID é um identificador, não um segredo: para senhas e segredos de API use um gerador de senhas próprio. Mais codificadores e inspetores estão nas ferramentas para desenvolvedores.