Gerador KSUID

KSUID (Identificador Único K-Sortável) é um identificador de 20 bytes composto por um prefixo de timestamp Unix de 4 bytes seguido por 16 bytes de dados aleatórios, codificado como uma string Base62 de 27 caracteres. Diferente do UUID v4 (que é totalmente aleatório e não ordenável), os KSUIDs são ordenados lexicograficamente por ordem de criação, tornando-os úteis para chaves primárias de banco de dados onde o ordenamento por tempo é desejado sem uma coluna de timestamp separada. UUID v7 é um padrão mais recente que também fornece UUIDs ordenados por tempo.

Inteiros com auto-incremento expõem contagens de registros, não são portáteis entre sistemas distribuídos e requerem geração de sequência centralizada. KSUIDs são globalmente únicos sem coordenação, incorporam o tempo de criação, são ordenados cronologicamente e são seguros para expor em URLs sem revelar métricas de negócios. A troca é um armazenamento maior (20 bytes vs 4–8 bytes para inteiros) e operações de índice ligeiramente mais lentas devido aos bytes altos aleatórios que impedem a inserção sequencial perfeita.

Base62 usa dígitos 0–9 e letras A–Z e a–z (62 caracteres no total). Diferente do Base64, não possui caracteres especiais (+, /, =) tornando-o seguro para URLs, nomes de arquivos e comparação de strings sem codificação. KSUID usa Base62 porque a string resultante de 27 caracteres é ordenada lexicograficamente na mesma ordem que o binário subjacente de 20 bytes, o que é crucial para que a propriedade de ordenamento por tempo funcione corretamente em comparações de strings.

Timestamps KSUID têm precisão de 1 segundo, usando um inteiro sem sinal de 4 bytes representando segundos desde uma época personalizada de 13 de maio de 2014 00:00:00 UTC. Esta época foi escolhida para que o timestamp não transborde até o ano de 2150. O componente aleatório de 16 bytes garante unicidade mesmo quando múltiplos KSUIDs são gerados no mesmo segundo em múltiplas máquinas, tornando colisões astronomicamente improváveis.