Первичный ключ это столбец или набор столбцов, который однозначно определяет каждую строку. Его значения должны быть уникальными и не 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 разбрасывают вставки по всему индексу, а на больших таблицах это обходится дороже.