Ir para o conteúdo
Promovaweb

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
  1. Tabelas com forma fixa
  2. O tipo decide o que entra na coluna
  3. Números exatos e números aproximados
  4. Texto, datas e fusos
  5. O nulo e o valor padrão
  6. Tipos ricos sem sair do SQL

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.
Cada coluna declara um tipo. O servidor confere o valor contra esse tipo em todo INSERT e UPDATE. O tipo também escolhe os operadores e os índices disponíveis para a coluna.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.