Como funcionam IDs auto-incrementais (SERIAL, sequences, IDENTITY)?

Question

Accepted Answer

PostgreSQL gera IDs auto-incrementais (normalmente para chaves primárias) usando **sequences** — objetos especiais que produzem números únicos crescentes. **`SERIAL`** é uma abreviação que cria uma sequence automaticamente, e **`IDENTITY`** é o equivalente moderno do padrão SQL.

## SERIAL — a abreviação clássica

```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` cria automaticamente uma sequence e define o padrão da coluna para puxar o próximo valor dela. `BIGSERIAL` usa `BIGINT` para intervalos maiores (importante para tabelas que podem exceder ~2 bilhões de linhas).

## IDENTITY — a forma moderna e recomendada (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` é a abordagem moderna e padrão SQL (preferida sobre `SERIAL` em código novo) — é mais limpa e evita algumas peculiaridades do `SERIAL` (como problemas de propriedade/permissões).

## Como sequences funcionam por baixo

```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
```

Uma sequence é um contador independente. `SERIAL`/`IDENTITY` usam uma por trás das cenas. Nota: sequences **não** são revertidas por transações (então IDs podem ter lacunas após rollbacks — normal e esperado).

## Obtendo o novo ID

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

## Por que isso importa

IDs auto-incrementais são fundamentais — quase toda tabela precisa de uma chave primária única, e IDs sequenciais gerados automaticamente são a abordagem padrão, então entender como PostgreSQL os trata é conhecimento essencial do dia a dia.

Conhecer **`SERIAL`** (a abreviação clássica e comum que cria uma sequence automaticamente) e especialmente **`IDENTITY`** (`GENERATED ... AS IDENTITY` — a abordagem moderna, padrão SQL e recomendada para código novo, que é mais limpa e evita as peculiaridades do SERIAL) é importante para definir chaves primárias corretamente.

Entender as **sequences** subjacentes (contadores independentes que produzem valores únicos crescentes) desmistifica como auto-increment funciona e é útil para controle avançado (`nextval`, `setval`).

Dois pontos práticos importam: escolher **`BIGSERIAL`/BIGINT`** para tabelas que podem crescer bastante (evitando overflow de inteiros — uma preocupação real) e saber que **sequences não são revertidas** por transações (então IDs podem ter lacunas após rollbacks ou inserts falhados — comportamento normal e esperado que surpreende alguns).

A cláusula **`RETURNING`** para obter o ID gerado de volta a partir de um INSERT também é valiosa, conhecimento do dia a dia.

Como toda tabela precisa de chaves primárias e IDs auto-incrementais são o padrão, e como entender SERIAL versus a IDENTITY recomendada, as sequences subjacentes, dimensionamento (BIGSERIAL), comportamento de lacunas e RETURNING cobre as necessidades práticas, saber como PostgreSQL gera IDs auto-incrementais é conhecimento fundamental e frequentemente aplicado para trabalhar com tabelas Postgres e um ponto comum onde conhecer a prática moderna recomendada (IDENTITY) reflete competência atual com Postgres.