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.

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

Основные функции генерации 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:

Создание таблиц с автоматической генерацией 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 без индекса - скан будет медленным.

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

1. Таблица с авто-генерацией: CREATE TABLE users (id uuid PRIMARY KEY DEFAULT gen_random_uuid(), email text UNIQUE);
2. Вставка без ID: INSERT INTO users (email) VALUES (‘test@example.com’) RETURNING id;
3. Миграция с 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 для временных рядов или протестировать коллизии на больших объемах данных, чтобы выбрать оптимальный подход под ваш проект.