Menu

Первичный ключ в PostgreSQL: IDENTITY, SERIAL и UUID

Как задать первичный ключ в PostgreSQL и как его генерировать: столбцы identity, более старый SERIAL и UUID через gen_random_uuid(). А также составные ключи и сброс последовательности.

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

Первичный ключ это столбец или набор столбцов, который однозначно определяет каждую строку. Его значения должны быть уникальными и не NULL, и в таблице может быть только один первичный ключ. В PostgreSQL его обычно генерирует сама база через столбец identity: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.

Значения id равны 1 и 2. Объявление ключа также создаёт по нему уникальный индекс с именем users_pkey.

Столбцы identity: ALWAYS или BY DEFAULT

Столбцы identity это стандартный для SQL способ нумеровать строки, доступный с PostgreSQL 10. Есть две формы:

  • GENERATED ALWAYS AS IDENTITY отклоняет явное значение в INSERT, если в нём не указано OVERRIDING SYSTEM VALUE. Это более безопасный вариант по умолчанию.
  • GENERATED BY DEFAULT AS IDENTITY использует сгенерированное значение, только если вы не передали своё.

При BY DEFAULT вставка собственных id оставляет последовательность позади, и следующий сгенерированный id совпадёт с существующим. После импорта строк с явными id передвиньте последовательность за самый большой из них через setval:

Без строки с setval последняя вставка получила бы id 1 и упала бы с ошибкой дубликата ключа. Со setval новая строка получает 4.

SERIAL или identity

serial (4 байта) и bigserial (8 байт) не настоящие типы. Это сокращение, которое создаёт последовательность и задаёт столбцу значение по умолчанию nextval() от неё:

Столбец получается обычным integer со значением по умолчанию nextval('legacy_id_seq'::regclass). Ничто не мешает вставке записать свой id, а последовательности нужны отдельные права. Столбцы identity решают обе проблемы, поэтому в новых таблицах выбирайте их. serial по-прежнему работает, и вы встретите его в старых схемах и учебниках.

Для таблиц, которые могут вырасти, используйте bigint (или bigserial). Ключ типа integer заканчивается примерно на 2,1 миллиарда значений.

Первичные ключи UUID

gen_random_uuid() возвращает случайный UUID версии 4. Функция встроена с PostgreSQL 13, расширение не нужно:

При каждом запуске id будут разными, по 36 символов в текстовом виде. Тип uuid хранит их в 16 байтах, поэтому используйте его, а не text. В PostgreSQL 18 появилась uuidv7(), которая генерирует упорядоченные по времени UUID, вставляемые в порядке индекса. В PostgreSQL 17 генерируйте их в приложении.

Составные первичные ключи

Ключ может охватывать несколько столбцов; его записывают отдельной строкой в CREATE TABLE. Это естественный ключ для связующей таблицы, где каждая пара может встретиться только один раз:

Повторная пара (1, 10) пропускается, поэтому count равен 3. Чтобы добавить ключ в существующую таблицу, используйте ALTER TABLE t ADD PRIMARY KEY (col). Остальные изменения описаны на странице об ALTER TABLE. Другие таблицы ссылаются на ключ через внешние ключи.

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

Есть ли в PostgreSQL AUTO_INCREMENT?

Не под этим именем. Стандартный способ это столбец identity, id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, доступный с PostgreSQL 10. Более старые типы serial и bigserial делают то же самое через последовательность и значение по умолчанию.

Почему в последовательности id в PostgreSQL есть пропуски?

Последовательность выдаёт значение, даже если вставка потом падает или её транзакция откатывается, и это значение больше не используется. Пропуски нормальны и безвредны, так что не рассчитывайте на то, что id идут подряд.

Создаёт ли первичный ключ индекс в PostgreSQL?

Да. Первичный ключ (как и любое ограничение UNIQUE) автоматически создаёт уникальный B-tree индекс; для первичного ключа он называется tablename_pkey.

Что выбрать для первичного ключа: UUID или bigint?

Ключи identity типа bigint меньше (8 байт против 16) и вставляются в порядке индекса. UUID можно сгенерировать где угодно без обращения к базе, и они не выдают, сколько строк в таблице. Случайные UUID разбрасывают вставки по всему индексу, а на больших таблицах это обходится дороже.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать