Validador UUID Regex Go

O que é UUID Regex?

Em Go, validar strings que devem seguir o formato UUID (Universally Unique Identifier) é comum em sistemas backend, APIs e registros de banco de dados. UUIDs garantem que cada entrada tenha um ID globalmente único, especialmente importante quando os sistemas escalam ou operam em vários servidores.

UUIDs geralmente têm o seguinte formato:

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

• x: Qualquer dígito hexadecimal

• M: Versão do UUID (1 a 5)

• N: Variante (8, 9, a ou b)

Um regex para validar UUIDs ajuda a garantir que:

• A entrada tem o comprimento correto

• Os segmentos estão formatados corretamente

• A versão e a variante do UUID são válidas

Padrão Regex para UUID Versão 7

Se você precisa corresponder especificamente ao UUID versão 7 (introduzido para identificadores ordenados por tempo), pode usar este padrão regex em Go (e na maioria das linguagens que suportam sintaxe regex padrão):

^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Este padrão verifica:

• 8 dígitos hexadecimais

• 4 dígitos hexadecimais

• Um dígito de versão (1 a 5)

• Um dígito de variante (8, 9, a, b)

• 12 dígitos hexadecimais finais

Diferenças para UUID v7:

• O terceiro segmento do UUID deve começar com 7 para especificar a versão 7.

• Os demais segmentos seguem as regras hexadecimais e de variante normais.

O que há de Novo no UUID Versão 7?

O UUID versão 7 traz uma abordagem moderna focada em ordenação baseada em tempo para melhor desempenho em sistemas distribuídos. Ao contrário das versões mais antigas, a versão 7 usa o timestamp Unix Epoch (em milissegundos desde 1º de janeiro de 1970, UTC) para construir seus valores únicos. Isso significa:

• Valores Ordenados por Tempo: Os IDs são naturalmente ordenáveis por hora de criação, o que pode acelerar significativamente operações em banco de dados e logs de eventos.

• Melhor Entropia: A versão 7 aprimora aleatoriedade e unicidade em relação às versões 1 e 6, reduzindo o risco de colisões.

• Escalabilidade: A estrutura baseada em tempo torna os UUIDs mais eficientes para aplicações de alto throughput em múltiplos servidores.

Anatomia de um UUID v7

Um UUID versão 7 tem 36 caracteres no total, incluindo hifens como separadores:

xxxxxxxx-xxxx-7xxx-Nxxx-xxxxxxxxxxxx

• Cada x é um dígito hexadecimal (0 a 9, a a f, ou A a F).

• O terceiro grupo sempre começa com 7, indicando a versão 7.

• A posição N no quarto grupo representa a variante (tipicamente 8, 9, a ou b).

Decomposição dos Segmentos

Uma string UUID v7 consiste em cinco grupos separados por hifens:

1. 8 dígitos hexadecimais

2. 4 dígitos hexadecimais

3. 4 dígitos hexadecimais (começando com "7")

4. 4 dígitos hexadecimais (primeiro dígito é 8, 9, a ou b)

5. 12 dígitos hexadecimais

Por exemplo, um UUID v7 válido pode ser:

01813b48-4c5d-7b10-bc18-3ccd3f89331f

Como Validar UUIDs em Go

Aqui está um exemplo funcional em Go:

package main
import (
"fmt"
"regexp"
)
func isValidUUID(uuid string) bool {
uuidRegex := regexp.MustCompile(^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
return uuidRegex.MatchString(uuid)
}
func main() {
test := "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
fmt.Println("Is UUID valid?", isValidUUID(test))
}

Validando UUID v7 com Regex em Diferentes Linguagens

Para validar especificamente UUID versão 7, ajuste seu regex para refletir que o dígito de versão deve ser "7".

Go / JavaScript / Python / Java:

[^0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Correspondendo UUIDs Sem Hifens

Se você precisar corresponder UUIDs sem hifens, o padrão fica:

^[0-9a-fA-F]{32}$

Esta versão verifica uma string de exatamente 32 caracteres hexadecimais, adequada para UUIDs no formato sem hifens.

Suporte a UUID v7 em Diferentes Linguagens

• PHP: Suporte nativo ao UUID v7 está emergindo em versões mais recentes e bibliotecas open source populares.

• JavaScript (ECMAScript): A API UUID oficial está evoluindo, mas pode ser necessário um polyfill moderno ou a biblioteca uuid.

• Python: Suporte via bibliotecas como uuid7 ou edições recentes da biblioteca padrão.

• Golang: Alguns pacotes populares já incluem suporte ao v7; sempre verifique suas dependências.

• Java: Suporte via pacotes de terceiros; o suporte nativo ainda é limitado.

• .NET: Versões mais recentes adicionam UUID v7 ao toolkit padrão.

• Rust: Versões mais recentes do crate UUID introduzem suporte ao v7.

Casos de Uso

• Atribuição de IDs em bancos de dados distribuídos

• Identificação de usuários ou sessões de API

• Garantia de unicidade em logs de sistema ou tokens

• Referência a arquivos, mensagens ou registros entre sistemas

Dicas Profissionais para Validação de UUID

• UUIDs podem ser maiúsculos ou minúsculos; este regex suporta ambos.

• UUIDs versão 4 são os mais comuns para geração aleatória. Você pode personalizar o padrão para corresponder apenas ao v4 substituindo [1-5] por 4.

• Sempre valide UUIDs antes de armazená-los no banco de dados para evitar dados inválidos.

• Use regexp.MustCompile() em vez de Compile() para padrões estáticos em Go; é mais rápido e mais limpo.

Combine com Estas Ferramentas

Crie fluxos completos de dados simulados combinando este validador com:

• Gerador de Chave de API: Atribua credenciais de acesso seguras junto com UUIDs.

• Gerador de Número de Telefone: Crie perfis de usuário realistas.

• Gerador de Email: Adicione IDs de email a dados de usuário simulados.

• Gerador de Nome de Usuário: Complete perfis falsos com nomes de usuário aleatórios.

• Gerador de Endereço: Combine UUIDs com dados de endereço de usuário para testes.