Modelo relacional e os tipos de cada coluna
No modelo relacional, os registros ficam em tabelas com colunas de nome e tipo declarados. Cada tipo determina os valores aceitos e os operadores disponíveis, por isso você compara preços como números e recebe um erro ao enviar abc para uma coluna integer.
Ficha e sumário da página
- Referência técnica
- PostgreSQL 18.7
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Tabelas com forma fixa
Como as colunas são fixas, uma informação nova sobre o cliente, como o telefone, entra na tabela por uma coluna criada com ALTER TABLE. Sem um valor padrão, as linhas existentes recebem NULL nessa coluna. Com DEFAULT, recebem o valor definido pela expressão. Você altera a estrutura da tabela para representar a informação nova, sem recriar cada cadastro no app.
O SQL não garante ordem nenhuma entre as linhas. Uma consulta sem ORDER BY devolve as linhas na ordem que o servidor achar mais barata. Essa ordem pode mudar depois de uma atualização ou de uma limpeza da tabela. O app que mostra uma lista ordenada declara a ordem na própria consulta.
O banco não cria automaticamente uma chave primária para a tabela. Duas linhas podem repetir todos os valores das colunas declaradas. O identificador físico ctid diferencia as versões armazenadas, mas muda com atualizações ou movimentações e não serve como chave estável do app. Você declara uma chave primária para identificar os registros, assunto da página Tabelas, chaves e restrições.
O tipo decide o que entra na coluna
A declaração de uma tabela é a lista de colunas com o tipo de cada uma. O desenho abaixo mostra uma tabela de assinaturas e o que cada tipo garante:
tabela assinaturas
Identificação
id bigint:- Inteiro de 8 bytes, a faixa usada em chaves de tabelas que crescem muito.
email text:- Texto sem limite de tamanho declarado.
plano varchar(20):- Texto com até 20 caracteres, com checagem de tamanho na gravação.
Valores e tempo
valor numeric(10,2):- Número exato com duas casas decimais, com arredondamento das casas excedentes.
ativa boolean:- Verdadeiro ou falso, além do nulo quando a coluna permite.
criada_em timestamptz:- Instante guardado em UTC, exibido no fuso da sessão.
Esse controle acontece no servidor. Um INSERT com o texto abc numa coluna inteira falha com erro de sintaxe de entrada para o tipo. Um plano com 25 caracteres também falha na coluna varchar(20) quando enviado sem conversão explícita. Uma conversão explícita para varchar(20) trunca o texto. A documentação registra uma exceção herdada do padrão SQL: os caracteres excedentes que forem só espaços são descartados sem erro.
Números exatos e números aproximados
Os inteiros vêm em três tamanhos: smallint com 2 bytes, integer com 4 bytes e bigint com 8 bytes. O integer cobre pouco mais de dois bilhões de valores positivos, uma faixa que tabelas de eventos e logs ultrapassam. Trocar uma chave integer por bigint depois exige reescrever a tabela, por isso muitas modelagens começam em bigint.
Para valores com casas decimais, o PostgreSQL separa o exato do aproximado. O numeric representa valores decimais sem a aproximação binária do ponto flutuante. Quando você declara uma escala, como duas casas em numeric(10,2), o servidor arredonda as casas excedentes e recusa valores cujo total de dígitos inteiros ultrapassa o permitido. Ele atende preço, saldo e qualquer valor monetário. O real e o double precision seguem o padrão de ponto flutuante IEEE 754, com representação binária aproximada: a soma de muitos valores pode acumular diferenças pequenas. Essas colunas atendem medidas científicas e coordenadas, mas não o saldo de uma carteira digital.
- Numéricossmallint, integer e bigint guardam inteiros. numeric representa decimais exatos. real e double precision usam aproximação binária.
- Textotext não declara limite. varchar(n) limita o tamanho. char(n) completa o valor com espaços.
- Data e horadate, timestamp, timestamptz e interval, com aritmética de datas no próprio SQL.
- Lógico e identificadorboolean para verdadeiro ou falso e uuid para identificadores de 128 bits.
- Documentosjson guarda o texto como veio, jsonb guarda em formato binário indexável.
- Estruturadosarrays de qualquer tipo, enums, faixas de valores e endereços de rede.
Texto, datas e fusos
Segundo a documentação, os três tipos de texto têm o mesmo desempenho. As diferenças ficam na checagem de tamanho das colunas com limite e no espaço extra do char(n), que completa o valor com espaços. O text sem limite atende a maioria das colunas. O varchar(n) faz sentido quando o limite pertence ao domínio, como uma sigla de estado com dois caracteres.
As datas exigem mais atenção. O timestamp guarda data e hora sem fuso, exatamente como chegaram. O timestamptz converte o valor recebido para UTC usando o fuso informado na entrada ou, na falta dele, o parâmetro TimeZone da sessão. Na leitura, o servidor converte de volta para o fuso da sessão. Um app com usuários em fusos diferentes grava timestamptz. Quando cada conexão define o TimeZone do próprio usuário, o horário chega convertido, sem conversão manual no código.
O nulo e o valor padrão
Toda coluna aceita NULL enquanto a tabela não declarar o contrário. O nulo representa um valor desconhecido, diferente de zero e de texto vazio. Ele muda o resultado das comparações: NULL = NULL não é verdadeiro, por isso a consulta usa IS NULL para encontrar as linhas sem valor. A restrição NOT NULL recusa a linha que chega sem a coluna preenchida.
A cláusula DEFAULT preenche a coluna que o INSERT deixou de fora. Com criada_em timestamptz DEFAULT now(), a linha recebe o instante de início da transação. Com ativa boolean DEFAULT true, a assinatura começa ativa. O valor padrão também passa pelas restrições da tabela, de modo que um padrão inválido falha como qualquer outro valor.
Tipos ricos sem sair do SQL
Além dos tipos clássicos, o PostgreSQL guarda arrays de qualquer tipo, enums com valores fixos, faixas de valores como tstzrange para períodos de reserva e endereços de rede com inet e cidr. Cada tipo traz operadores próprios: um array responde se contém um elemento, uma faixa responde se sobrepõe outra e um inet responde se pertence a uma sub-rede.
Os tipos jsonb e uuid, muito presentes em APIs e apps com IA, têm uma página própria, Extensões: pgvector, JSONB e UUID. O próximo assunto mostra como o seu código chega até essas tabelas, da string de conexão ao processo que o servidor abre para cada cliente, na página Como o app conversa com o banco.