O que são colunas geradas?

Question

Accepted Answer

Uma **coluna gerada** é uma coluna cujo valor é **calculado automaticamente** a partir de outras colunas, em vez de ser inserido diretamente. PostgreSQL suporta **colunas geradas armazenadas** (Postgres 12+) — o valor calculado é computado na escrita e armazenado. Elas mantêm dados derivados consistentes automaticamente.

## Definindo uma coluna gerada

```sql
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  price NUMERIC,
  quantity INT,
  -- a STORED generated column — computed from price and quantity
  total NUMERIC GENERATED ALWAYS AS (price * quantity) STORED
);

INSERT INTO products (price, quantity) VALUES (10, 3);
SELECT total FROM products;          -- 30 — computed automatically (you didn't insert it)
```

A cláusula `GENERATED ALWAYS AS (expression) STORED` faz com que `total` seja sempre igual a `price * quantity` — computado em insert/update e armazenado. Você não pode (e não deve) inserir nela diretamente; ela é sempre derivada.

## Usos comuns

```sql
-- a full name from parts
full_name TEXT GENERATED ALWAYS AS (first_name || ' ' || last_name) STORED

-- a normalized/lowercased value for searching
email_lower TEXT GENERATED ALWAYS AS (lower(email)) STORED

-- area from dimensions
area NUMERIC GENERATED ALWAYS AS (width * height) STORED

-- extract a value from JSONB into a real column (then index it)
user_id INT GENERATED ALWAYS AS ((data->>'user_id')::int) STORED
```

Colunas geradas são ótimas para valores derivados que você consulta frequentemente — elas permanecem consistentes automaticamente e podem ser **indexadas** (já que armazenadas).

## Colunas geradas vs computação em queries vs triggers

```text
Generated column → derived value computed automatically, stored, indexable, consistent
Computing in a query (price*qty in SELECT) → no storage, but recomputed every query,
                                              can't be indexed directly
Trigger → more flexible but more complex; generated columns are simpler for pure derivations
→ Use generated columns for simple, deterministic derived values you query/index often.
```

## Por que isso importa

Colunas geradas são um recurso útil do PostgreSQL para **manter automaticamente dados derivados**, e entendê-las é valioso para manter valores computados consistentes e consultáveis.

O benefício principal é que o valor de uma coluna gerada é sempre automaticamente computado a partir de outras colunas e mantido em sincronia — então dados derivados (totais, nomes completos, valores normalizados, campos JSONB extraídos) permanecem **consistentes por construção** sem que código de aplicação ou atualizações manuais precisem lembrar de recomputá-los (eliminando uma classe de bugs em que dados derivados saem de sincronia).

Porque colunas geradas armazenadas fisicamente armazenam o valor, elas também podem ser **indexadas** — o que é particularmente valioso para coisas como um email em minúsculas para busca insensível a maiúsculas/minúsculas, ou extrair um campo JSONB em uma coluna real e indexável (um padrão poderoso combinando flexibilidade JSONB com indexação relacional).

Entender quando usar colunas geradas versus alternativas — colunas geradas para valores derivados simples e determinísticos que você consulta ou indexa frequentemente (consistentes, indexáveis, simples), versus computação em queries (sem armazenamento mas recomputado a cada vez e não diretamente indexável) ou triggers (mais flexível mas mais complexo) — reflete bom julgamento de design.

Já que manter dados derivados/computados de forma consistente é uma necessidade comum, e como colunas geradas fornecem uma forma automática, consistente e indexável de fazer isso (mais limpa que manutenção manual ou triggers para derivações simples), entender colunas geradas é conhecimento valioso e praticamente relevante do PostgreSQL para projetar esquemas onde valores computados são mantidos corretos automaticamente e feitos eficientemente consultáveis — um recurso PostgreSQL moderno e útil para modelagem de dados limpa e consistente.