Generatore UUID

Un UUID (universally unique identifier, chiamato GUID nei software Microsoft) è un numero a 128 bit scritto come 32 cifre esadecimali in gruppi 8-4-4-4-12, per esempio f47ac10b-58cc-4372-a567-0e02b2c3d479. È stato standardizzato nel 2005 con la RFC 4122; a maggio 2024 quel documento è stato sostituito dalla RFC 9562, che mantiene le versioni precedenti e ne aggiunge tre nuove. Due posizioni sono fisse: la prima cifra del terzo gruppo indica la versione (il 4 in 4372), mentre la prima cifra del quarto gruppo indica la variante, che è 8, 9, a o b per ogni UUID conforme alla RFC.

La versione 4 riempie gli altri 122 bit con dati casuali. Lo spazio è così vasto che servirebbe generarne circa 2,7 trilioni di miliardi (2,7 × 10¹⁸) per avere il 50% di probabilità di un solo duplicato: per questo i sistemi creano ID v4 in modo indipendente su molte macchine, senza coordinarsi. Questa pagina usa crypto.randomUUID, oppure crypto.getRandomValues quando non è disponibile, e mai Math.random, il cui risultato non è progettato per essere imprevedibile. Le opzioni Maiuscole e Senza trattini cambiano solo la formattazione: il valore resta lo stesso e la maggior parte dei parser accetta entrambe le forme.

Le versioni 1 e 6 sono costruite da un timestamp e da un ID del nodo, in origine l'indirizzo MAC del computer, che rivela dove e quando è stato creato l'ID. Le versioni 3 e 5 calcolano l'hash di un namespace e di un nome con MD5 o SHA-1, quindi lo stesso input produce sempre lo stesso UUID. La versione 8 è un formato libero per schemi personalizzati. La novità più importante è la versione 7: inizia con un timestamp Unix a 48 bit in millisecondi e riempie il resto con bit casuali, così gli ID si ordinano per data di creazione.

Questo ordinamento è il motivo per valutare la v7 come chiave primaria di un database. Le chiavi v4 casuali si distribuiscono su tutto l'indice B-tree, dividendo le pagine e peggiorando la località della cache man mano che la tabella cresce, mentre le chiavi v7 arrivano in ordine più o meno crescente come una colonna auto-increment, ma si possono comunque generare senza un contatore centrale. Scegliere la v4 quando serve un ID che non riveli nulla, nemmeno il momento di creazione; scegliere la v7 quando contano le prestazioni di inserimento e l'ordine temporale. Un UUID è un identificatore, non un segreto: per password e chiavi API segrete usare un generatore di password dedicato. Altri codificatori e strumenti di analisi sono negli strumenti per sviluppatori.