Generator UUID

Czym jest generator UUID?

Generator UUID tworzy uniwersalnie unikalne identyfikatory (Universally Unique Identifiers), czyli 128-bitowe wartości, które statystycznie na pewno nie powtórzą się z żadnym innym UUID wygenerowanym gdziekolwiek indziej. Programiści używają ich jako kluczy głównych wierszy w bazie danych, identyfikatorów zasobów API, nazw danych testowych, identyfikatorów wiadomości w kolejkach i identyfikatorów w systemach rozproszonych.

UUID są przydatne, bo każda maszyna może wygenerować taki identyfikator samodzielnie i mieć pewność, że nikt inny nie uzyska tej samej wartości. Nie ma centralnego licznika, sekwencji do uzgadniania ani zapytania do serwera. Dzięki temu sprawdzają się wszędzie tam, gdzie system musi tworzyć identyfikatory bez pytania o zgodę.

*GUID* (Globally Unique Identifier) to nazwa, jakiej Microsoft używa dla tego samego 128-bitowego identyfikatora. W codziennej pracy programisty GUID i UUID oznaczają to samo: różne ekosystemy po prostu wolą różne nazwy.

Czego nauczysz się, generując UUID

• UUID v4 jest najpopularniejszy: całkowicie losowy i świetny jako identyfikator ogólnego przeznaczenia.
• UUID v7 jest *uporządkowany w czasie*, więc daje tę samą unikalność co v4, ale dobrze współpracuje z indeksami bazy danych (wiersze są wstawiane mniej więcej chronologicznie).
• UUID to *identyfikator*, a nie *sekret*. Nie używaj go jako tokenu dostępu, chyba że jest częścią szerszego projektu zabezpieczeń.
• UUID zapisuje się jako 32 znaki szesnastkowe w 5 grupach oddzielonych łącznikami: 8-4-4-4-12.

Jak generować UUID krok po kroku

1. 1

   Wybierz wersję

   Wybierz v4 dla losowych identyfikatorów, v7 dla identyfikatorów uporządkowanych w czasie, które dobrze się indeksują, albo v1 dla starszych systemów wymagających znacznika czasu i identyfikatora węzła.

2. 2

   Ustaw liczbę

   Wygeneruj jeden UUID, gdy potrzebujesz szybkiego id, albo do 1000 naraz, gdy wypełniasz bazę danych lub tworzysz przykładowe odpowiedzi API.

3. 3

   Wybierz format

   Włącz lub wyłącz wielkie litery, łączniki i nawiasy klamrowe ({...}), aby dopasować się do konwencji twojej bazy danych, kodu lub platformy.

4. 4

   Kliknij Kopiuj lub Kopiuj wszystko

   Skopiuj pojedynczy UUID albo całą listę. Wszystko jest generowane lokalnie w twojej przeglądarce.

Wersje UUID: szybka ściągawka

Pięć popularnych wersji UUID i kiedy po którą sięgnąć.

Przykłady UUID do wypróbowania

{  "id": "550e8400-e29b-41d4-a716-446655440000",  "name": "Lesson 1",  "createdAt": "2026-04-25T10:00:00Z"}

Częste błędy z UUID

• Traktowanie UUID jako dowodu, że użytkownik jest właścicielem zasobu. To tylko identyfikator: autoryzuj żądania osobno.
• Używanie UUID jako haseł lub tokenów sesji. Domyślnie nie są wystarczająco tajne do takiego celu.
• Mieszanie w jednej bazie danych formatów z wielkimi i małymi literami, w nawiasach klamrowych i bez łączników bez jasnego kroku normalizacji.
• Domyślne używanie UUID v4 jako klastrowanego klucza głównego w mocno obciążonej bazie danych: losowe identyfikatory fragmentują indeks. W takim przypadku użyj v7 (lub sekwencyjnego id).
• Generowanie UUID przez Math.random() lub słabe generatory liczb losowych. Zawsze używaj crypto.randomUUID() z platformy albo jego odpowiednika.

Generator UUID: najczęstsze pytania