UUID v4 и UUID v7

Что такое UUID v4 и UUID v7

UUID v4 несёт 122 случайных бита. В нём нет ни последовательности, ни часов, ни данных для расшифровки, поэтому это самый безопасный вариант, когда идентификатор не должен ничего раскрывать и создаётся где угодно. UUID v7 оставляет 74 случайных бита, но первые 48 отдаёт метке времени Unix в миллисекундах (плюс несколько бит счётчика внутри миллисекунды), поэтому два значения, созданные с разницей в минуту, сравниваются как строки в том же порядке.

Следствие проявляется в индексе. При случайных ключах каждая вставка попадает в новое место B-дерева: страницы разбиваются, рабочий набор растёт, а скорость записи падает по мере увеличения таблицы. С v7 вставки приходят к правому краю дерева и ведут себя почти как автоинкремент, сохраняя возможность создавать значение на любом узле без координации.

Платить за это приходится раскрытием информации. Метка времени в v7 сообщает любому, у кого есть значение, примерное время создания — с точностью до миллисекунды. Если это нежелательно, правильный ответ — v4. Оба формата определены в RFC 9562; v4 — более старый, перенесённый из RFC 4122.

Как использовать

1. Нужны ключи для индексируемой таблицы? Берите v7 — генератор выше переключает версию одним кликом.
2. Идентификатор публикуется или не должен ничего раскрывать? Берите v4.
3. Переводите существующий столбец? Преобразовать значения нельзя; новые строки могут использовать v7, старые останутся v4 — оба допустимы в одном столбце.

Сценарии

• Таблицы событий и логов, куда строки только добавляются: упорядоченный ключ держит индекс компактным.
• Публичные URL и id в API, где v4 не раскрывает время создания ресурса.
• Несколько пишущих узлов, где обе версии создаются без координатора, а v7 дополнительно даёт приблизительный порядок.

Сравнение UUID v4 и UUID v7 с другими форматами

Примеры кода

Оба в JavaScript

// v4 — встроено
const v4 = crypto.randomUUID();

// v7 — пакет uuid
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();   // 019535d9-3df7-79fb-b466-fa907fa17f9e

Оба в Python

import uuid

uuid.uuid4()     # случайный
uuid.uuid7()     # упорядоченный, Python 3.14+

Чтение метки времени

import uuid

u = uuid.UUID('019535d9-3df7-79fb-b466-fa907fa17f9e')
print(u.version)     # 7

# PostgreSQL 18 умеет это в запросе:
# SELECT uuid_extract_timestamp(id) FROM events;

Частые вопросы