Expressão definida na tabela
Uma coluna gerada é uma coluna cujo valor o banco calcula por uma expressão definida na estrutura da tabela. Essa expressão pode combinar outras colunas da mesma linha. O cálculo permanece associado à definição da coluna, então a aplicação informa os valores de origem e o banco produz o resultado.
O tipo armazenado, indicado por STORED, calcula o resultado na inserção ou atualização e o grava na tabela. O tipo virtual, indicado por VIRTUAL, calcula o resultado na leitura. O PostgreSQL 18 oferece os dois tipos, enquanto o PostgreSQL 17 oferece somente o armazenado. Você precisa conferir a versão instalada ao escolher a definição.
Conversão de centímetros para polegadas
Um exemplo didático baseado na documentação do PostgreSQL é uma tabela com altura_cm e uma coluna gerada definida por altura_pol numeric GENERATED ALWAYS AS (altura_cm / 2.54) STORED. Ao inserir 254 em altura_cm, o cálculo produz 100 polegadas. Quando a altura de origem muda para 127, o banco recalcula o resultado para 50.
A expressão mantém as duas medidas relacionadas. Um valor padrão seria avaliado na inserção e não acompanharia as alterações posteriores de altura_cm. No PostgreSQL, você também não pode substituir diretamente o resultado da coluna gerada por um valor informado pela aplicação.
Restrições do cálculo
O PostgreSQL exige funções imutáveis, cujos resultados não mudam para os mesmos argumentos. A expressão deve trabalhar com a própria linha e não pode consultar outra tabela nem referenciar outra coluna gerada. Por isso, um cálculo que depende da hora atual ou de uma consulta externa precisa de outra forma de implementação.
Dúvidas frequentes
Perguntas frequentes sobre coluna gerada
- Qual é a diferença entre coluna gerada e valor padrão?
- No PostgreSQL, o valor padrão preenche a coluna na inserção quando outro valor não é informado. A coluna gerada segue sua expressão e reflete as mudanças nas colunas de origem.
- Posso informar diretamente o resultado no INSERT?
- O PostgreSQL não aceita um valor calculado pela aplicação para a coluna gerada. O comando pode omitir essa coluna ou usar DEFAULT para que o banco aplique a expressão.
- A expressão pode consultar outra tabela?
- No PostgreSQL, a expressão não pode usar subconsultas nem referências a outras linhas. As funções precisam ser imutáveis e a expressão também não pode referenciar outra coluna gerada.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: colunas geradas
Explica os tipos armazenado e virtual, a diferença em relação a DEFAULT e as restrições das expressões no PostgreSQL.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
O desenvolvimento acompanhado pode ajudar você a revisar a modelagem de colunas calculadas e o código que grava a tabela.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na modelagem de uma aplicação, você precisa distinguir os valores informados pelo código daqueles calculados pelo próprio banco.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.