UUID в SQL

Что такое UUID в SQL

Хранить UUID текстом — самая распространённая дорогая ошибка. В PostgreSQL есть родной тип uuid ровно на 16 байт; в MySQL 8 можно взять BINARY(16) с UUID_TO_BIN(); в SQL Server — uniqueidentifier. Все три компактнее и быстрее в сравнении, чем строка из 36 символов, и все три проверяют значение при записи.

Выбор версии в базе важнее, чем где-либо ещё, — из-за индекса. Случайные значения v4 разбрасываются по B-дереву, и каждая вставка затрагивает новую страницу; упорядоченный по времени v7 держит новые строки рядом, и вставки остаются дешёвыми. Именно поэтому в PostgreSQL 18 появилась функция uuidv7(); на более старых версиях и в других СУБД v7 создаётся в приложении и передаётся как параметр.

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

1. Выберите функцию для своей СУБД: uuidv7(), gen_random_uuid(), UUID() или NEWID().
2. Назначьте её значением по умолчанию, чтобы вставки не указывали значение вручную.
3. Храните в родном типе (16 байт), а не в тексте, и используйте v7, если столбец индексируется.

Сценарии

• Первичные ключи, которые создаются без обращения к базе, например в распределённом сервисе.
• Идемпотентный импорт: детерминированный v5 из исходной строки защищает от дублей при повторном запуске.
• Публичные идентификаторы, которые не должны раскрывать число строк, в отличие от автоинкремента.

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

Примеры кода

PostgreSQL

-- Случайный v4 (pgcrypto или встроено с PostgreSQL 13)
SELECT gen_random_uuid();

-- Упорядоченный v7 (PostgreSQL 18+)
SELECT uuidv7();

-- Значение по умолчанию и запросы метаданных
CREATE TABLE events (
  id uuid PRIMARY KEY DEFAULT uuidv7(),
  created_at timestamptz NOT NULL DEFAULT now()
);
SELECT uuid_extract_version(id), uuid_extract_timestamp(id) FROM events;

MySQL

SELECT UUID();                        -- v1, основан на времени
SELECT UUID_TO_BIN(UUID(), 1);         -- байты v1 со временем вперёд: удобно индексу

CREATE TABLE events (
  id BINARY(16) PRIMARY KEY DEFAULT (UUID_TO_BIN(UUID(), 1)),
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

SELECT BIN_TO_UUID(id, 1) FROM events; -- обратно в текст

SQL Server

SELECT NEWID();                -- v4, случайный
SELECT NEWSEQUENTIALID();      -- упорядоченный, но только как значение по умолчанию

CREATE TABLE events (
  id UNIQUEIDENTIFIER NOT NULL DEFAULT NEWSEQUENTIALID(),
  created_at DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME(),
  CONSTRAINT pk_events PRIMARY KEY CLUSTERED (id)
);

Детерминированные ключи

-- PostgreSQL: стабильный id из естественного ключа
SELECT md5('tenant:42')::uuid;

-- Надёжнее: пространство имён вместо произвольного хэша
SELECT uuid_generate_v5(uuid_ns_url(), 'https://example.com/tenant/42');

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