UUID v4 atau v7: mana yang dipakai untuk primary key
Keduanya 128 bit dan tampak sama, tetapi isinya berbeda: v4 sepenuhnya acak, v7 diawali waktu pembuatan. Perbedaan itu menentukan kinerja indeks database dan informasi apa yang ikut terbaca dari ID Anda.
Tata letak bit v4 dan v7
UUID adalah angka 128 bit yang ditulis sebagai 32 digit heksadesimal dalam kelompok 8-4-4-4-12. RFC 9562 (Mei 2024), pengganti RFC 4122, mendefinisikan kedua versi dengan tata letak berikut. Bit 0 adalah bit paling kiri.
| Bit (panjang) | v4 | v7 |
|---|---|---|
| 0–47 (48) | acak | waktu Unix (ms) |
| 48–51 (4) | versi 0100 | versi 0111 |
| 52–63 (12) | acak | acak/penghitung |
| 64–65 (2) | varian 10 | varian 10 |
| 66–127 (62) | acak | acak |
Jadi v4 punya 122 bit acak, sedangkan v7 punya 48 bit waktu dan 74 bit sisanya. Dalam bentuk teks, digit pertama kelompok ketiga adalah versinya, dan digit pertama kelompok keempat selalu 8, 9, a, atau b karena dua bit variannya 10. Waktu di v7 bisa dibaca langsung dari 12 digit pertama:
01a1fbd4-f500-7c3a-9e21-5b8d40f1a6c7
0x01a1fbd4f500 = 1795226400000 ms
= 2026-11-21 02:00:00 UTC
= 21 Nov 2026 09.00 WIB
Angka itu adalah Unix timestamp dalam milidetik; panduan Unix timestamp menjelaskan cara membacanya.
Kenapa v7 membantu indeks database
Primary key biasanya disimpan di indeks B-tree, yang menjaga kunci tetap urut. Di MySQL InnoDB, baris tabelnya sendiri disusun menurut primary key. RFC 9562 bagian 2.1 menyebut masalah v4: nilai yang dibuat berturut-turut tidak berdekatan di indeks, sehingga setiap baris baru masuk ke halaman acak. Halaman yang penuh dipecah, halaman yang setengah kosong bertambah, dan bagian indeks yang perlu ada di memori mendekati seluruh indeks.
UUID v7 yang dibuat belakangan selalu lebih besar daripada yang dibuat sebelumnya pada milidetik lain, jadi baris baru masuk di ujung kanan indeks seperti angka auto-increment. Bedanya, aplikasi bisa membuat ID sebelum menyimpan ke database, misalnya untuk dikirim ke antrean atau dipakai sebagai kunci idempoten. Urutan byte dan urutan teks heksadesimal huruf kecil sama, jadi pengurutan sebagai teks pun benar.
Di dalam satu milidetik, urutannya bergantung pada implementasi. RFC 9562 bagian 6.2 memberi tiga cara: penghitung di belakang timestamp, nilai acak yang juga berfungsi sebagai penghitung, atau pecahan milidetik. Python memakai penghitung 42 bit, PostgreSQL memakai pecahan milidetik, sedangkan dokumentasi Node.js menyatakan randomUUIDv7() tidak dijamin selalu naik.
Peluang tabrakan
Untuk n UUID v4, peluang ada dua yang sama kira-kira n² ÷ (2 × 2122):
| Jumlah UUID v4 | Peluang ada yang sama |
|---|---|
| 1 juta | 9,4 × 10−26 |
| 1 miliar | 9,4 × 10−20 |
| 1 triliun | 9,4 × 10−14 |
| 2,7 × 1018 | 50% |
UUID v7 hanya bisa bertabrakan dengan UUID lain dari milidetik yang sama. Dengan 74 bit acak, 1.000 UUID per milidetik dari generator yang berbeda memberi peluang sekitar 2,6 × 10−17 per milidetik, atau sekitar 8 × 10−7 setelah setahun penuh pada laju itu. Generator yang memakai sebagian bit sebagai penghitung punya lebih sedikit bit acak, tetapi penghitungnya mencegah tabrakan di dalam generator yang sama. Semua hitungan ini berlaku hanya bila bit acaknya berasal dari generator acak kriptografis, seperti yang disarankan RFC 9562 bagian 6.9. UUID yang dibuat dengan Math.random tidak memenuhinya.
Kapan v7 sebaiknya tidak ditampilkan
Siapa pun yang melihat UUID v7 bisa membaca waktu pembuatannya sampai milidetik, seperti contoh di atas. Pada ID akun, pesanan, atau dokumen yang muncul di URL publik, itu membuka kapan akun dibuat atau kapan transaksi terjadi. RFC 9562 bagian 8 menyebut timestamp di UUID sebagai celah serangan yang sangat kecil, dan menegaskan bahwa UUID tidak boleh dianggap sulit ditebak serta tidak boleh dipakai sebagai kapabilitas keamanan, yaitu ID yang cukup diketahui untuk mendapat akses. Jalan tengahnya: v7 sebagai primary key internal, v4 untuk ID yang tampil ke luar. Link reset kata sandi dan undangan butuh token acak khusus, bukan UUID.
Membuat UUID di kode
JavaScript. crypto.randomUUID() di browser hanya tersedia di halaman HTTPS. Di Node.js 14.17 sampai 18, ambil dari modul node:crypto, karena objek crypto global baru tersedia tanpa flag sejak Node.js 19.
// v4: browser (HTTPS), Node.js 19+
crypto.randomUUID();
// v7: Node.js 24.16+ atau 26.1+
import { randomUUIDv7 }
from 'node:crypto';
randomUUIDv7();
// v7 di browser: paket npm uuid 10+
import { v7 } from 'uuid';
v7();
Python. uuid7() tersedia sejak Python 3.14, dan atribut time pada UUID v7 berisi milidetik Unix.
import uuid
uuid.uuid4()
uuid.uuid7() # Python 3.14+
uuid.uuid7().time # milidetik Unix
PostgreSQL. Simpan di kolom bertipe uuid (16 byte), bukan teks 36 karakter. gen_random_uuid() ada di inti PostgreSQL sejak versi 13; uuidv7() sejak versi 18. uuid_extract_timestamp() muncul di versi 17 untuk v1 saja, dan versi 18 menambahkan v7.
SELECT gen_random_uuid(); -- v4, PG 13+
SELECT uuidv7(); -- PG 18+
CREATE TABLE pesanan (
id uuid PRIMARY KEY DEFAULT uuidv7(),
total numeric NOT NULL
);
SELECT uuid_extract_timestamp(id)
FROM pesanan; -- v7: PG 18+
Membuat dan memeriksa UUID di swift.id
- Buka UUID Generator & Validator dan pilih Versi 4 (acak) atau Versi 7 (urut waktu).
- Isi Jumlah (1-1000), lalu atur format bila perlu: Huruf besar, Tanpa tanda hubung, atau Kurung kurawal { }. Seribu UUID v7 yang dibuat sekaligus tetap urut, karena alat ini memakai penghitung 12 bit.
- Tekan Salin atau Unduh .txt, atau Buat baru untuk mengganti semuanya.
- Tempel UUID apa pun di Periksa UUID untuk melihat versi, varian, dan untuk v1, v6, v7 waktu pembuatannya, termasuk nilai Unix milidetik yang bisa dicek di Konversi Unix Timestamp.
Pertanyaan umum
Bolehkah mencampur v4 dan v7 di satu kolom?
uuid menerima semua versi. Baris lama tetap tersebar acak di indeks; hanya baris baru yang masuk berurutan.Apakah v7 lebih mudah ditebak daripada v4?
Kenapa UUID v7 dari dua server tidak urut sempurna?
Berapa ukuran UUID di database?
uuid di PostgreSQL menyimpan 16 byte. Disimpan sebagai teks, bentuk standar 36 karakter butuh lebih dari dua kali lipat, dan indeksnya ikut membesar.