Jak działają auto-inkrementacyjne identyfikatory (SERIAL, sekwencje, IDENTITY)?

Question

Accepted Answer

PostgreSQL generuje auto-inkrementacyjne identyfikatory (zazwyczaj dla kluczy głównych) za pomocą **sekwencji** — specjalnych obiektów, które produkują unikatowe rosnące liczby. **`SERIAL`** to skrótowy zapis, który automatycznie tworzy sekwencję, a **`IDENTITY`** to nowoczesny odpowiednik zgodny ze standardem SQL.

## SERIAL — klasyczne skrócenie

```sql
CREATE TABLE users (
  id SERIAL PRIMARY KEY,      -- auto-incrementing integer (SERIAL = INT + a sequence)
  name TEXT
);
-- BIGSERIAL for larger ranges (BIGINT-backed) — use for tables expecting many rows

INSERT INTO users (name) VALUES ('Ann');   -- id auto-assigned (1, 2, 3, ...)
```

`SERIAL` automatycznie tworzy sekwencję i ustawia domyślną wartość kolumny, aby pobierała następną wartość z niej. `BIGSERIAL` używa `BIGINT` dla większych zakresów (ważne dla tabel, które mogą przekroczyć ~2 miliardy wierszy).

## IDENTITY — nowoczesny, zalecany sposób (Postgres 10+)

```sql
CREATE TABLE users (
  id INT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,   -- SQL-standard, recommended
  name TEXT
);
-- GENERATED ALWAYS → you can't manually insert a value (cleaner)
-- GENERATED BY DEFAULT → allows manual override when needed
```

`GENERATED ... AS IDENTITY` to nowoczesne, zgodne ze standardem SQL podejście (preferowane zamiast `SERIAL` w nowym kodzie) — jest czystsze i unika niektórych dziwactw `SERIAL` (takich jak problemy z własnością/uprawnieniami).

## Jak działają sekwencje pod maską

```sql
CREATE SEQUENCE my_seq START 1 INCREMENT 1;
SELECT nextval('my_seq');     -- get the next value (advances the sequence)
SELECT currval('my_seq');     -- the last value YOU got
SELECT setval('my_seq', 100); -- set the current value
```

Sekwencja to niezależny licznik. `SERIAL`/`IDENTITY` używają jednej w tle. Uwaga: sekwencje **nie są** wycofywane przez transakcje (więc identyfikatory mogą mieć luki po wycofaniu — normalne i oczekiwane).

## Pobieranie nowego identyfikatora

```sql
-- RETURNING — get the generated id back from an INSERT (very useful)
INSERT INTO users (name) VALUES ('Ann') RETURNING id;
```

## Dlaczego to ważne

Auto-inkrementacyjne identyfikatory są fundamentalne — prawie każda tabela potrzebuje unikalnego klucza głównego, a automatycznie generowane sekwencyjne identyfikatory to standardowe podejście, dlatego zrozumienie, jak PostgreSQL je obsługuje, to niezbędna codzienna wiedza.

Znajomość **`SERIAL`** (klasycznego, powszechnego skrócenia, które automatycznie tworzy sekwencję) i szczególnie **`IDENTITY`** (`GENERATED ... AS IDENTITY` — nowoczesne, zgodne ze standardem SQL, zalecane podejście dla nowego kodu, które jest czystsze i unika dziwactw SERIAL) jest ważna dla prawidłowego definiowania kluczy głównych.

Zrozumienie podstawowych **sekwencji** (niezależnych liczników, które produkują unikatowe rosnące wartości) demistyfikuje, jak działa auto-inkrementacja i jest przydatne dla zaawansowanej kontroli (`nextval`, `setval`).

Dwie praktyczne kwestie są ważne: wybór **`BIGSERIAL`/BIGINT`** dla tabel, które mogą rosnąć (unikając przepełnienia liczby całkowitej — rzeczywisty problem) i wiedza, że **sekwencje nie są wycofywane** przez transakcje (więc identyfikatory mogą mieć luki po wycofaniu lub nieudanych wstawieniach — normalne, oczekiwane zachowanie, które niektórych zaskakuje).

Klauzula **`RETURNING`** do pobierania wygenerowanego identyfikatora z INSERT jest również cenna, codzienna wiedza.

Ponieważ każda tabela potrzebuje kluczy głównych, a auto-inkrementacyjne identyfikatory są standardem, i ponieważ zrozumienie SERIAL vs zalecanego IDENTITY, podstawowych sekwencji, wielkości (BIGSERIAL), zachowania luk i RETURNING obejmuje praktyczne potrzeby, wiedza o tym, jak PostgreSQL generuje auto-inkrementacyjne identyfikatory, jest fundamentalna, często stosowana wiedza do pracy z tabelami Postgres i częstym punktem, gdzie znajomość nowoczesnej najlepszej praktyki (IDENTITY) odzwierciedla obecną kompetencję w Postgres.