Версии UUID Объяснены

Структура UUID

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

time_low (32 bits)time_mid (16 bits)M = version (4 bits) + time_hi (12)N = variant (2 bits) + clock (14)node / random (48 bits)

UUID v1Time-based (MAC)Sortable

Структура

timestamp (60-bit) + clock seq (14-bit) + MAC (48-bit)

Риск коллизии

Very low

6ba7b810-9dad-11d1-80b4-00c04fd430c8

Преимущества

+Globally unique
+Sortable by time
+Embeds creation time

Недостатки

−Exposes MAC address (privacy risk)
−Requires MAC or pseudo-random node
−Clock adjustments can cause duplicates

Лучше всего подходит для

Legacy systems. Avoid in new projects due to MAC address exposure.

UUID v3Name-based (MD5)Not sortable

Структура

MD5(namespace UUID + name) → UUID

Риск коллизии

MD5 collision risk (low for UUIDs)

6fa459ea-ee8a-3ca4-894e-db77e160355e

Преимущества

+Deterministic — same input = same UUID
+Can recreate UUIDs from known inputs

Недостатки

−MD5 is cryptographically weak
−Not random — attackers can predict given namespace+name
−Prefer v5 for new projects

Лучше всего подходит для

Generating UUIDs from URLs, email addresses, or other stable identifiers. Use v5 instead.

UUID v4RandomNot sortable

Структура

122 random bits + 4-bit version + 2-bit variant

Риск коллизии

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

Преимущества

+Extremely low collision probability
+No timestamp/MAC leakage
+Simple generation — no state needed
+Most widely supported

Недостатки

−Not sortable by generation time
−Random order degrades B-tree performance in databases
−Cannot verify when a UUID was created

Лучше всего подходит для

Default choice for most applications. IDs for records, sessions, tokens.

UUID v5Name-based (SHA-1)Not sortable

Структура

SHA-1(namespace UUID + name) → UUID (top 128 bits)

Риск коллизии

SHA-1 — extremely low for UUID purposes

886313e1-3b8a-5372-9b90-0c9aee199e5d

Преимущества

+Deterministic like v3, but uses SHA-1
+Stronger hash than MD5 (v3)
+Standard namespaces: DNS, URL, OID, X.500

Недостатки

−SHA-1 is fully deterministic — not suitable for secrets
−Truncates SHA-1 to 128 bits

Лучше всего подходит для

Deterministic IDs from a namespace + name. Example: UUID for 'https://example.com' is always the same.

UUID v7Time-ordered RandomSortable

Структура

Unix ms timestamp (48-bit) + version (4-bit) + random (74-bit)

Риск коллизии

Very low (74 random bits)

018f0b2d-4c9e-7abc-89de-f012345678ab

Преимущества

+Sortable by time (great for database primary keys)
+Does NOT expose MAC address
+Near-zero collision probability
+RFC 9562 standard

Недостатки

−Slightly less entropy than v4 (74 vs 122 bits)
−Requires a time source
−Newer — less library support than v4

Лучше всего подходит для

Database primary keys where sort order matters. Replaces v1 for time-ordered UUIDs.

UUID v8CustomSortable

Структура

128 bits, content defined by the implementation

Риск коллизии

Depends on implementation

2489e9ad-f195-8b67-82da-3291d8c9fc1b

Преимущества

+Fully customizable
+Useful for embedding application-specific data

Недостатки

−No standard semantics — interoperability must be documented
−Not widely supported

Лучше всего подходит для

Experimental or vendor-specific use cases where v1–v7 don't fit.

Быстрое Сравнение

Version	Method	Sortable	Privacy-safe	Deterministic
v1	Time + MAC	✅	❌ (MAC leak)	❌
v3	MD5 hash	❌	✅	✅
v4	Random	❌	✅	❌
v5	SHA-1 hash	❌	✅	✅
v7	Time + Random	✅	✅	❌
v8	Custom	—	—	—

Генерация UUID в Коде

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

Руководство по UUID: версии, форматы и лучшие практики

UUID в сравнении с другими форматами идентификаторов

ULID (Universally Unique Lexicographically Sortable Identifier)

ULID — это компактная альтернатива: 48-битная метка времени + 80-битное случайное значение, закодированное в 26 символах Crockford Base32. Они сортируются лексикографически по времени создания.

Когда использовать автоинкрементные идентификаторы

Последовательные идентификаторы проще и эффективнее для приложений с одной базой данных. Используйте UUID, когда вам нужно:

Генерировать идентификаторы несколькими системами независимо
Идентификаторы, которые не раскрывают порядок вставки внешним пользователям
Идентификаторы, совместимые со слиянием данных в распределённых базах

Вопросы производительности баз данных

-- PostgreSQL: нативный тип UUID (16 байт, эффективный)
CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name TEXT NOT NULL
);

-- MySQL: хранение в BINARY(16) для производительности
CREATE TABLE users (
  id BINARY(16) PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

Часто задаваемые вопросы

Можно ли использовать UUID как токены безопасности?

UUID v4 использует 122 бита случайности из криптографического источника, что обеспечивает хорошую энтропию. Однако для токенов безопасности (API-ключи, идентификаторы сессий) лучше использовать специализированные форматы токенов с дополнительными свойствами, такими как контрольные суммы, кодирование срока действия или префиксная идентификация. UUID предназначены для идентификации, а не для аутентификации.

FAQ по Версиям UUID

Что такое UUID?

UUID (Universally Unique Identifier) — это 128-битный идентификатор, стандартизированный в RFC 4122. Форматируется как 8-4-4-4-12 шестнадцатеричных символов, разделённых дефисами. Разработан для уникальности в пространстве и времени без центрального органа.

Какую версию UUID использовать?

Используйте v4 для большинства общих целей — генерируется случайно и имеет крайне низкую вероятность коллизии. Используйте v7 для временно упорядоченных UUID в качестве первичных ключей базы данных. Используйте v5 для детерминированных UUID из пары namespace+имя. Избегайте v1 в новых проектах — раскрывает MAC-адрес.

В чём разница между UUID v4 и v7?

UUID v4 полностью случайный (122 случайных бита). UUID v7 кодирует временную метку Unix в первых 48 битах, за которыми следуют случайные биты. Это делает UUID v7 сортируемыми по времени создания, значительно улучшая производительность B-tree индексов.

Действительно ли ID UUID v4 уникальны?

Практически да. UUID v4 имеет 122 случайных бита, давая 2^122 ≈ 5,3 × 10^36 возможных значений. Чтобы иметь 50% шанс коллизии, нужно было бы сгенерировать около 2,7 × 10^18 UUID.

Инструмент поиска IP-адреса Шпаргалка Markdown: примеры для копирования Предпросмотр Markdown Онлайн — Редактор Шпаргалка по Regex — Полный Справочник Тестер regex: проверка регулярных выражений онлайн Справочник HTTP-кодов состояния — Описание всех кодов

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Генерация UUID в Коде

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

Руководство по UUID: версии, форматы и лучшие практики

UUID в сравнении с другими форматами идентификаторов

ULID (Universally Unique Lexicographically Sortable Identifier)

Когда использовать автоинкрементные идентификаторы

Генерировать идентификаторы несколькими системами независимо
Идентификаторы, которые не раскрывают порядок вставки внешним пользователям
Идентификаторы, совместимые со слиянием данных в распределённых базах

Вопросы производительности баз данных

-- PostgreSQL: нативный тип UUID (16 байт, эффективный)
CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name TEXT NOT NULL
);

-- MySQL: хранение в BINARY(16) для производительности
CREATE TABLE users (
  id BINARY(16) PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

Версии UUID Объяснены

Структура UUID

Быстрое Сравнение

Генерация UUID в Коде

Руководство по UUID: версии, форматы и лучшие практики

UUID в сравнении с другими форматами идентификаторов

ULID (Universally Unique Lexicographically Sortable Identifier)

Когда использовать автоинкрементные идентификаторы

Вопросы производительности баз данных

Часто задаваемые вопросы

Можно ли использовать UUID как токены безопасности?

FAQ по Версиям UUID

Что такое UUID?

Какую версию UUID использовать?

В чём разница между UUID v4 и v7?

Действительно ли ID UUID v4 уникальны?

Связанные инструменты

Версии UUID Объяснены

Структура UUID

Быстрое Сравнение

Генерация UUID в Коде

Руководство по UUID: версии, форматы и лучшие практики

UUID в сравнении с другими форматами идентификаторов

ULID (Universally Unique Lexicographically Sortable Identifier)

Когда использовать автоинкрементные идентификаторы

Вопросы производительности баз данных

Часто задаваемые вопросы

Можно ли использовать UUID как токены безопасности?

FAQ по Версиям UUID

Что такое UUID?

Какую версию UUID использовать?

В чём разница между UUID v4 и v7?

Действительно ли ID UUID v4 уникальны?

Связанные инструменты