PostgreSQL generate UUID: функции, примеры и настройка для таблиц

kirilljsx

В PostgreSQL генерация UUID решает задачу создания уникальных идентификаторов для записей в таблицах. Это особенно полезно в распределенных системах, где последовательные ID могут конфликтовать. С помощью простых расширений и функций вы легко настроите автоматическую генерацию UUID для первичных ключей.

UUID - это 128-битный идентификатор, который почти гарантированно уникален глобально. Он помогает избежать проблем с дубликатами ID при слиянии данных из разных источников. В этой статье разберем, как подключить нужные модули, генерировать UUID и применять их в реальных таблицах.

Подключение расширений для UUID

PostgreSQL не имеет встроенных функций для генерации UUID по умолчанию, но предоставляет готовые расширения. Основные - это uuid-ossp и pgcrypto, которые добавляют функции вроде uuid_generate_v4() и gen_random_uuid(). Сначала нужно установить пакет postgresql-contrib, если его нет: для Ubuntu это команда sudo apt install postgresql-contrib-версия.

После установки подключаем расширение в базе данных командой CREATE EXTENSION IF NOT EXISTS “uuid-ossp”;. Это безопасно - IF NOT EXISTS предотвратит ошибку при повторном запуске. Альтернатива - pgcrypto с функцией gen_random_uuid(), которая доступна с PostgreSQL 13 без дополнительных пакетов. Выбор зависит от версии СУБД и требований к совместимости.

Вот базовые шаги подключения:

Установите postgresql-contrib через менеджер пакетов.
Выполните CREATE EXTENSION для uuid-ossp или pgcrypto.
Проверьте: SELECT gen_random_uuid(); должно выдать случайный UUID.

Важно: расширения подключаются на уровне базы данных, а не кластера.

Расширение	Функции	Версия PG	Преимущества
uuid-ossp	uuid_generate_v1(), v4(), v5()	Все	Много версий UUID
pgcrypto	gen_random_uuid()	13+	Встроено, просто

Основные функции генерации UUID

Функция uuid_generate_v4() из uuid-ossp создает полностью случайный UUID версии 4 - 6 байт случайных, плюс 2 байта версии и варианта. Это стандарт для большинства случаев, вероятность коллизии минимальна даже для миллиардов записей. Пример: SELECT uuid_generate_v4(); вернет что-то вроде 351c1afe-21b2-486c-951b-66bc9e852530.

gen_random_uuid() из pgcrypto работает аналогично, но проще в новых версиях PG. Она криптографически стойкая и не требует установки доппакетов. Для версий 1 используйте uuid_generate_v1() - включает MAC-адрес и timestamp, но менее анонимна. В PostgreSQL 18 добавлена uuid_generate_v7() для упорядоченных по времени UUID.

Применение на практике:

Случайный UUID: SELECT uuid_generate_v4()::uuid;
Вставка: INSERT INTO table (id) VALUES (gen_random_uuid());
Проверка уникальности: индексы на UUID работают как на любых 128-битных полях.

Таблица сравнения версий UUID:

Версия	Функция	Состав	Использование
1	uuid_generate_v1()	Timestamp + MAC	Упорядочено по времени
4	uuid_generate_v4(), gen_random_uuid()	Случайные биты	Основное
5	uuid_generate_v5()	Хеш namespace + имя	Детерминировано
7	uuid_generate_v7()	Timestamp + случайное	Новое, sortable

Создание таблиц с автоматической генерацией UUID

Для первичного ключа объявите колонку типа uuid с DEFAULT. Пример таблицы contacts: CREATE TABLE contacts (contact_id uuid DEFAULT uuid_generate_v4() PRIMARY KEY, name text);. При вставке без указания id значение сгенерируется автоматически: INSERT INTO contacts (name) VALUES (‘Иван’);

Это удобно для моделей в ORM вроде Bun или SQLAlchemy - укажите default:uuid_generate_v4(). UUID как PK лучше последовательностей в распределенных системах, но индексы занимают больше места. Для производительности используйте BRIN-индексы на UUIDv7. Избегайте UUID в WHERE без индекса - скан будет медленным.

Практические примеры:

Таблица с авто-генерацией: CREATE TABLE users (id uuid PRIMARY KEY DEFAULT gen_random_uuid(), email text UNIQUE);
Вставка без ID: INSERT INTO users (email) VALUES (‘test@example.com’) RETURNING id;
Миграция с serial: ALTER TABLE old_table ADD COLUMN new_id uuid DEFAULT uuid_generate_v4();.

Нюанс: при репликации убедитесь, что расширение подключено на всех нодах.

Преимущества и ограничения UUID в PostgreSQL

Сравнивая с BIGINT IDENTITY, UUID выигрывает в глобальной уникальности - нет нужды в центральном генераторе ID. Они анонимны и подходят для публичных API. Минусы: размер 16 байт vs 8 у bigint, фрагментация B-дерева при случайной вставке. В новых PG v7 решает проблему сортировки.

Когда использовать:

Распределенные системы.
Микросервисы с несколькими БД.
Тестирование с фабриками данных.

UUID упрощает жизнь разработчикам, но тестируйте производительность на нагрузке. Для высоких нагрузок комбинируйте с шардингом или LSM-движками вроде YugabyteDB.

UUID на практике: от теории к production

Генерация UUID в PostgreSQL - это баланс между простотой и эффективностью. Мы разобрали расширения, функции и таблицы, но есть нюансы вроде производительности индексов или интеграции с языками вроде Go и Python. Стоит поэкспериментировать с v7 для временных рядов или протестировать коллизии на больших объемах данных, чтобы выбрать оптимальный подход под ваш проект.