Klucz główny to kolumna albo zestaw kolumn, który identyfikuje każdy wiersz. Jego wartości muszą być unikalne i nie mogą być NULL, a tabela może mieć tylko jeden. W PostgreSQL zwykle pozwalasz bazie generować go przez kolumnę identity: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.
Identyfikatory to 1 i 2. Zdefiniowanie klucza tworzy też na nim unikalny indeks o nazwie users_pkey.
Kolumny identity: ALWAYS vs BY DEFAULT
Kolumny identity to standardowy w SQL sposób numerowania wierszy, dostępny od PostgreSQL 10. Są dwie formy:
GENERATED ALWAYS AS IDENTITYodrzuca jawną wartość wINSERT, chyba że wstawienie zawieraOVERRIDING SYSTEM VALUE. To bezpieczniejszy wybór domyślny.GENERATED BY DEFAULT AS IDENTITYużywa wygenerowanej wartości tylko wtedy, gdy jej nie podasz.
Przy BY DEFAULT wstawianie własnych identyfikatorów zostawia sekwencję w tyle, a następny wygenerowany identyfikator koliduje. Po imporcie wierszy z jawnymi identyfikatorami przesuń sekwencję za najwyższy z nich przez setval:
Bez linii z setval ostatnie wstawienie dostałoby identyfikator 1 i zakończyłoby się błędem duplikatu klucza. Z nią nowy wiersz dostaje 4.
SERIAL vs identity
serial (4 bajty) i bigserial (8 bajtów) nie są prawdziwymi typami. To skrót, który tworzy sekwencję i ustawia wartość domyślną kolumny na jej nextval():
Kolumna to zwykły integer z wartością domyślną nextval('legacy_id_seq'::regclass). Nic nie powstrzymuje wstawienia przed zapisaniem własnego identyfikatora, a sekwencja potrzebuje osobnych uprawnień. Kolumny identity rozwiązują oba problemy, więc wybieraj je w nowych tabelach. serial nadal działa i spotkasz go w starszych schematach i tutorialach.
Używaj bigint (albo bigserial) w tabelach, które mogą rosnąć. Klucz integer kończy się po około 2,1 miliarda wartości.
Klucze główne UUID
gen_random_uuid() zwraca losowy UUID w wersji 4. Jest wbudowana od PostgreSQL 13, więc rozszerzenie nie jest potrzebne:
Każde uruchomienie wypisuje inne identyfikatory, każdy ma 36 znaków w postaci tekstowej. Typ uuid przechowuje je w 16 bajtach, więc używaj go zamiast text. PostgreSQL 18 dodaje uuidv7(), które generuje UUID uporządkowane w czasie, wstawiane w kolejności indeksu. W PostgreSQL 17 generuj je w aplikacji.
Złożone klucze główne
Klucz może obejmować kilka kolumn i wtedy zapisuje się go w osobnej linii w CREATE TABLE. To naturalny klucz dla tabeli łączącej, w której każda para może wystąpić raz:
Powtórzona para (1, 10) zostaje pominięta, więc licznik to 3. Żeby dodać klucz do istniejącej tabeli, użyj ALTER TABLE t ADD PRIMARY KEY (col). Strona o ALTER TABLE omawia inne zmiany. Inne tabele wskazują na klucz przez klucze obce.
Najczęściej zadawane pytania
Czy PostgreSQL ma AUTO_INCREMENT?
Nie pod tą nazwą. Standardowy sposób to kolumna identity, id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, dostępna od PostgreSQL 10. Starsze typy serial i bigserial robią to samo przez sekwencję i wartość domyślną.
Dlaczego w mojej sekwencji identyfikatorów w PostgreSQL są luki?
Sekwencja wydaje wartość nawet wtedy, gdy wstawienie potem się nie uda albo jego transakcja zostanie wycofana, a ta wartość nigdy nie jest używana ponownie. Luki są normalne i nieszkodliwe, więc nie licz na to, że identyfikatory idą po kolei.
Czy klucz główny tworzy indeks w PostgreSQL?
Tak. Klucz główny (i każde ograniczenie UNIQUE) automatycznie tworzy unikalny indeks B-tree, dla klucza głównego nazwany tablename_pkey.
UUID czy bigint jako klucz główny?
Klucze identity typu bigint są mniejsze (8 bajtów wobec 16) i są wstawiane w kolejności indeksu. UUID można wygenerować wszędzie bez odpytywania bazy i nie zdradzają, ile jest wierszy. Losowe UUID rozrzucają wstawienia po całym indeksie, co przy dużych tabelach kosztuje więcej.