Gerador de UUID

Como usar o gerador de UUID

1. Escolhe a Versão do UUID: v4 (aleatório) para identificadores totalmente aleatórios ou v7 (ordenado no tempo) para identificadores ordenados pela data de criação.
2. Indica em Quantidade quantos UUIDs precisas, de 1 a 1000.
3. Se quiseres, ativa Maiúsculas ou desativa os Hífenes caso o sistema onde os vais usar espere a forma compacta de 32 caracteres.
4. Clica em Gerar e depois copia a lista para a área de transferência ou transfere-a num ficheiro .txt com um UUID por linha.

O que é um UUID?

Um UUID (Universally Unique Identifier), também conhecido como GUID no mundo Microsoft, é um valor de 128 bits usado para identificar algo sem precisar de uma autoridade central que distribua números. Escreve-se normalmente como 32 algarismos hexadecimais em cinco grupos separados por hífenes, segundo o padrão 8-4-4-4-12, por exemplo f47ac10b-58cc-4372-a567-0e02b2c3d479. O primeiro algarismo do terceiro grupo é a versão, e o primeiro algarismo do quarto grupo codifica a variante (8, 9, a ou b nos UUIDs padrão).

Como qualquer computador pode criar um UUID de forma independente com uma probabilidade de colisão desprezável, os UUIDs são muito usados como chaves primárias de bases de dados, IDs de pedido e de correlação em registos, nomes de ficheiros enviados, chaves de idempotência em APIs e identificadores em sistemas distribuídos onde vários servidores criam registos ao mesmo tempo.

Versão 4 ou versão 7

As duas versões estão definidas no RFC 9562, a norma de 2024 que substituiu o RFC 4122.

O UUID v4 é quase totalmente aleatório: 122 dos seus 128 bits vêm de um gerador aleatório, e os 6 bits restantes guardam a versão e a variante. Não revela nada sobre quando ou onde foi criado. A probabilidade de colisão é tão pequena que terias de gerar cerca de 103 biliões (103 × 10¹²) de UUIDs v4 para chegares a uma probabilidade de um em mil milhões de obter um único duplicado. Escolhe o v4 quando quiseres identificadores opacos que não transportam informação.

O UUID v7 começa com um timestamp Unix de 48 bits em milissegundos, seguido da versão, da variante e de 74 bits aleatórios. Por isso, os UUIDs v7 gerados mais tarde ficam ordenados depois dos gerados antes. Isto é muito importante nas bases de dados: as chaves v4 aleatórias são inseridas em posições dispersas de um índice B-tree, provocando divisões de páginas e má localidade de cache, enquanto as chaves v7 são acrescentadas perto do fim, tal como um inteiro com autoincremento. Escolhe o v7 para chaves primárias e para tudo o que queiras ordenar pela data de criação. Lembra-te de que a hora de criação pode ser lida num UUID v7, por isso evita-o quando essa informação for sensível.

Aleatoriedade e segurança

Esta ferramenta usa o gerador de números aleatórios criptograficamente seguro do navegador (a API Web Crypto), e não o Math.random(), que não foi concebido para ser imprevisível. Os UUIDs são gerados localmente no teu dispositivo e nunca são enviados nem registados por um servidor, por isso ninguém vê os valores que crias.

Mesmo assim, um UUID é um identificador, não um segredo. Não confies apenas num UUID impossível de adivinhar para proteger um documento privado ou uma ligação de reposição de palavra-passe; combina-o com uma autenticação adequada e um prazo de validade.

Opções de formatação

A forma canónica é em minúsculas com hífenes, e o RFC 9562 recomenda minúsculas. Alguns sistemas, como ferramentas Windows mais antigas ou certas bases de dados, mostram os GUIDs em maiúsculas, e alguns formatos de armazenamento preferem a forma de 32 caracteres sem hífenes. As duas opções só mudam a representação em texto; o valor de 128 bits subjacente é idêntico, e a maioria dos parsers aceita todas estas formas.