Gerador de GUID e UUID

UUID v4 é a opção aleatória de uso geral. Depois que os bits obrigatórios de versão e variante são definidos, restam 122 bits aleatórios. É um bom padrão para clientes independentes, dados de teste, identificadores públicos de recursos e sistemas que não precisam que o próprio identificador revele um horário.

UUID v7 coloca um timestamp Unix em milissegundos nos 48 bits mais significativos e, nesta implementação, usa bits aleatórios para o espaço variável restante. Isso faz valores de milissegundos diferentes ordenarem aproximadamente por criação quando os relógios avançam, o que pode ajudar na revisão de logs e em alguns padrões de índice.

A versão 7 não é uma promessa de ordem estrita de geração. Este gerador não acrescenta contador monotônico nem sequência submilissegundo. Valores criados no mesmo milissegundo contêm bits finais aleatórios, e um relógio de dispositivo que retrocede pode romper a ordenação visível.

A forma familiar com hífens é uma apresentação textual de 16 bytes. Os cinco grupos têm 8, 4, 4, 4 e 12 dígitos hexadecimais, mas os grupos não são strings aleatórias separadas. O nibble de versão aparece no começo do terceiro grupo, e a variante RFC aparece no primeiro dígito hexadecimal do quarto grupo.

O exemplo v4 público fixo 550e8400-e29b-41d4-a716-446655440000 tem 4 na posição de versão e a na posição de variante RFC. O dígito de variante pode ser 8, 9, a ou b para a variante RFC porque os bits iniciais são 10. Essas posições explicam como a inspeção reconhece campos; elas não revelam se os outros bits foram gerados aleatoriamente. Um valor escrito à mão pode imitar o mesmo padrão.

O inspetor também reconhece valores nulo e máximo como sentinelas especiais. Nulo são todos os bits zero; máximo são todos os bits um. Eles podem ter significado estrutural em um protocolo, mas não são identificadores aleatórios gerados e não devem ser confundidos com valores únicos comuns.

Para UUID v7, ClockTools pega um timestamp de milissegundo do relógio do dispositivo para o lote e o grava nos seis primeiros bytes de cada valor. Cada valor ainda recebe bytes aleatórios novos antes que os bits de versão e variante sejam definidos. Se o valor do relógio estiver fora do intervalo do campo de timestamp v7 de 48 bits, ele é rejeitado e a geração falha, sem truncar o timestamp.

A contagem única é local ao lote gerado atual. O gerador usa um Set e tentativas limitadas para que saídas aleatórias duplicadas dentro do lote solicitado não sejam retornadas. Ele não consulta um registro global, um banco de dados, outra aba ou valores produzidos ontem.

Probabilidade ainda não é o mesmo que uma regra de negócio. Se chaves duplicadas teriam consequência, imponha unicidade onde os identificadores são armazenados e trate erros de conflito ali. A geração não consegue conhecer o estado da sua aplicação. Uma nova geração com falha limpa o lote anterior em vez de deixar um resultado antigo parecendo uma nova solicitação bem-sucedida, então copie os dados de teste necessários antes de experimentar o próximo lote.

Formato de texto é útil quando o receptor espera um UUID impresso. Minúsculas é a saída canônica do navegador usada pelo gerador, maiúsculas é para sistemas com essa convenção, chaves e aspas são envoltórios, sem hífens é a forma compacta de 32 hexadecimais, e URN acrescenta o prefixo urn:uuid:.

Codificação é outra camada. Texto simples preserva o formato de texto selecionado. Saída com codificação URL codifica esse texto percentualmente. Base64 e Base64 URL ignoram o envoltório de formato de texto e codificam os 16 bytes brutos em ordem de rede; o seletor de formato é desativado para essas codificações porque chaves ou letras maiúsculas não fazem parte do valor em bytes.

Apresentação decide como vários valores são organizados. Um por linha é o mais fácil de revisar. CSV cria uma linha de campos separados por vírgulas. Array JSON é útil para dados de teste e código. Valores SQL cria valores entre aspas separados por vírgulas; é uma lista de valores, não uma instrução SQL completa.

Para o UUID fixo 550e8400-e29b-41d4-a716-446655440000, as codificações de bytes são VQ6EAOKbQdSnFkRmVUQAAA== em Base64 e VQ6EAOKbQdSnFkRmVUQAAA em Base64 URL. O texto comum tem 36 caracteres, o hexadecimal compacto tem 32, Base64 com preenchimento tem 24, e esta forma Base64 URL sem preenchimento tem 22. Eles representam os mesmos 16 bytes. Codificar os 36 caracteres ASCII impressos em vez disso codificaria outra entrada e não produziria esses resultados de bytes.

RFC 4648 descreve os alfabetos Base64 e seguro para URL. A forma segura para URL substitui os caracteres mais e barra usados pelo Base64 comum e, nesta ferramenta, omite o preenchimento final. Maiúsculas e minúsculas ainda importam em qualquer alfabeto Base64; não coloque em minúsculas um valor Base64 como se fosse texto UUID hexadecimal. Codificação URL é uma terceira escolha: chaves viram %7B e %7D, enquanto letras, dígitos e hífens do UUID canônico não precisam de substituição percentual.

Ordem de bytes faz parte de um contrato de intercâmbio. Esta página codifica bytes na mesma ordem de rede do texto hexadecimal canônico. A documentação de Guid.ToByteArray da Microsoft mostra que sua saída de bytes sem parâmetros inverte os três primeiros grupos de campos em relação ao texto. Se o receptor usa essa representação, compare explicitamente a ordem de bytes documentada; concordar que os dois campos contêm um GUID não estabelece que suas strings Base64 serão iguais.

Aspas também são uma camada. O formato de texto Entre aspas acrescenta caracteres de aspas a cada valor; uma apresentação JSON então escapa essas aspas dentro da string, e CSV as escapa dentro de um campo. Aspas escapadas extras podem, portanto, ser serialização correta e ainda assim estar erradas para um receptor que queria um UUID sem envoltório. Minúsculas mais Texto simples é um ponto de partida direto para importações JSON e CSV. Valores SQL usa strings entre aspas simples; forneça a estrutura de consulta ao redor separadamente e prefira consultas parametrizadas da aplicação em vez de colar strings geradas em uma consulta ativa.

Uma estrutura válida significa que o texto se encaixa em uma forma UUID aceita e que seus campos de versão e variante podem ser lidos. Ela não prova que o identificador foi gerado pelo ClockTools, por Web Crypto, por um serviço específico ou no horário v7 decodificado.

Para UUID v7, o timestamp é evidência útil apenas dentro de uma investigação maior. Ele pode refletir o relógio do dispositivo usado por um gerador, um timestamp alterado deliberadamente ou um valor de teste copiado. Trate-o como pista de ordenação e então compare com logs de servidor, timestamps de banco de dados e registros de auditoria confiáveis.

O inspetor aceita hexadecimal compacto ou texto com hífens, e pode remover envoltórios comuns como chaves, parênteses, aspas ou um prefixo urn:uuid: antes de conferir. Ele não decodifica Base64, Base64 URL ou entrada com codificação URL para validação; decodifique essas representações no sistema receptor antes da inspeção estrutural.

A inspeção aceita um identificador por vez, não uma linha CSV exportada ou array JSON. Usar valor gerado cola o primeiro UUID original do lote atual, não sua exibição codificada, então você pode inspecionar um lote mesmo com Base64 selecionado. O inspetor reconhece versões RFC aceitas de 1 a 8, mas a geração oferece apenas v4 e v7. Um aviso de variante não aceita ainda pode exibir uma forma normalizada; isso não é uma validação RFC bem-sucedida nem permissão para reescrever os campos do protocolo de origem.

Um erro de quantidade significa que a contagem não é um número inteiro de 1 a 1.000. A ferramenta não arredonda, limita nem reduz silenciosamente a solicitação. Um erro de fonte aleatória significa que Web Crypto não forneceu bytes aleatórios utilizáveis, então nenhum identificador foi gerado.

Um erro de codificação pode ocorrer quando um navegador não tem a API necessária para a codificação de saída escolhida. Mude para Texto simples para recuperar o lote subjacente ou tente outro navegador. Uma falha de geração é diferente: ela descarta o lote em vez de manter valores parciais. Falhas de área de transferência, compartilhamento e download não regeneram identificadores. Quando o acesso de exportação falhar, selecione manualmente a saída visível se ela estiver disponível; confira downloads antes de presumir que um arquivo iniciado foi salvo.

Não cole segredos de produção em um relatório de UUID. Um UUID pode ser público, privado ou sensível à segurança dependendo de como seu sistema o usa, mas a forma sozinha não faz dele uma senha. Para tokens de portador, redefinições de senha ou credenciais de API, use um gerador de segredos e controles de ciclo de vida próprios para isso.