Che cos'è un UUID v5?
Un UUID v5 applica SHA-1 all'UUID del namespace insieme al nome e poi fissa i bit di versione e variante. La stessa coppia produce sempre lo stesso UUID.
È il modo abituale di creare identificatori stabili a partire da ciò che già identifica la risorsa: un dominio, un indirizzo e-mail o un percorso canonico. Il v5 è anche il mattone dell'indicizzazione deterministica nei sistemi di ricerca.
Come si usa
- Seleziona il namespace che corrisponde al tuo caso.
- Scrivi il nome esatto da convertire in identificatore.
- Fai clic su Genera e conserva o copia l'UUID ottenuto.
Casi d'uso
- Chiavi stabili per record che hanno già una chiave naturale.
- Sincronizzazione fra sistemi senza una sequenza condivisa.
- Indicizzazione riproducibile di documenti e cataloghi.
Le versioni UUID in breve
| Versione | Ordinabile | Basata su | Usala per |
|---|---|---|---|
| v1 | No | Timestamp + indirizzo MAC | Sistemi storici che si aspettano ancora il v1 |
| v3 | No | Hash MD5 di un nome | Identificatori deterministici quando MD5 è obbligatorio |
| v4 | No | 122 bit casuali | Quasi tutti gli identificatori di uso generale |
| v5 | No | Hash SHA-1 di un nome | Quando lo stesso nome deve dare sempre lo stesso ID |
| v6 | Sì | Timestamp riordinato | Identificatori ordinabili senza rinunciare al casuale |
| v7 | Sì | Tempo Unix in millisecondi | Chiavi primarie di database e ID di eventi |
| v8 | No | Il tuo layout di bit | Formati proprietari o sperimentali |
Tutte e sette le versioni sono da 128 bit e si scrivono nella stessa forma 8-4-4-4-12. Cambia solo il significato dei bit.
Domande frequenti
Posso risalire al nome dall'UUID?
No. SHA-1 è una funzione a senso unico: si può solo verificare se un certo nome produce quell'UUID, non invertire il calcolo.
Quali namespace esistono?
La RFC 9562 ne definisce quattro standard: DNS, URL, OID e X.500. Anche qualsiasi UUID valido può fungere da namespace personalizzato.
Il v5 sostituisce il v4?
No: risolvono problemi diversi. Il v4 garantisce l'unicità casuale, il v5 garantisce la riproducibilità. Usa il v4 quando non esiste una chiave naturale.