Menu

Klucz główny w PostgreSQL: identity, SERIAL i UUID

Jak zdefiniować klucz główny w PostgreSQL i jak go generować: kolumny identity, starszy SERIAL i UUID przez gen_random_uuid(). Do tego klucze złożone i resetowanie sekwencji.

Na tej stronie są działające edytory: edytuj, uruchamiaj i od razu zobacz wynik.

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 IDENTITY odrzuca jawną wartość w INSERT, chyba że wstawienie zawiera OVERRIDING SYSTEM VALUE. To bezpieczniejszy wybór domyślny.
  • GENERATED BY DEFAULT AS IDENTITY uż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.

Ilustracja języków programowania w Coddy

Ucz się programowania z Coddy

Zacznij