Modelagem: tabelas, chaves e restrições
Uma restrição é uma condição que você declara na tabela para limitar os valores aceitos ou as relações entre registros. O PostgreSQL confere as condições aplicáveis a cada alteração e recusa, por exemplo, uma compra com chave estrangeira apontando para um cliente inexistente.
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 ligadas por chaves
A modelagem divide as informações do app em tabelas que guardam um assunto cada: clientes numa tabela, compras em outra, produtos numa terceira. As ligações entre elas ficam em colunas que repetem a chave da outra tabela. Uma compra guarda o cliente_id em vez de copiar nome e e-mail do cliente, por isso a troca de e-mail acontece numa linha só e todas as compras enxergam o valor novo.
clientes (id PK)Uma linha por cliente, com e-mail unique.compras (id PK)cliente_id aponta para clientes.id.itens_compraChave primária composta por compra_id e produto_id.produtos (id PK)itens_compra.produto_id aponta para cá, com check de preço positivo.
Esse desenho evita a mesma informação em dois lugares. Com o nome do cliente copiado em cada compra, uma correção no cadastro deixaria as compras antigas com o nome errado. Com a chave, a informação existe num lugar só. A consulta junta as tabelas na hora da leitura, com JOIN.
Chave primária
A chave primária identifica cada linha da tabela. Ela combina duas restrições: os valores não se repetem e nenhum deles é nulo. Uma tabela tem no máximo uma chave primária, que pode ser uma coluna ou um grupo de colunas, como compra_id e produto_id na tabela de itens. Ao declarar a chave, o PostgreSQL cria sozinho um índice B-tree único sobre ela.
A coluna da chave costuma ser um bigint gerado pelo banco, com GENERATED ALWAYS AS IDENTITY, ou um uuid. O número sequencial ocupa 8 bytes e cresce em ordem. O uuid ocupa 16 bytes e pode ser gerado no próprio app antes do INSERT. Dois serviços podem gerar identificadores separadamente. A chave primária continua necessária para recusar uma eventual repetição. A URL de uma API com uuid também não revela quantos registros existem. A página Extensões: pgvector, JSONB e UUID mostra a diferença entre o uuidv4 aleatório e o uuidv7 ordenado pelo tempo, novo no PostgreSQL 18.
Chave estrangeira
A chave estrangeira declara que um valor não nulo precisa existir na chave referenciada, da mesma tabela ou de outra. A documentação chama essa garantia de integridade referencial. Uma coluna que também precisa estar preenchida recebe NOT NULL. Uma compra com cliente_id igual a 999 falha quando não existe cliente 999, mesmo que o código do app tenha esquecido de conferir.
A exclusão do lado referenciado segue a ação declarada na chave. O padrão é NO ACTION, que recusa apagar um cliente com compras. O RESTRICT recusa da mesma forma, sem adiar a checagem para o fim da transação. O CASCADE apaga junto as linhas que apontam para o cliente. O SET NULL e o SET DEFAULT trocam a coluna da compra por nulo ou pelo valor padrão, desde que o resultado continue atendendo às demais restrições.
Unique, check e not null
A restrição unique recusa valores repetidos numa coluna ou num grupo de colunas, como o e-mail do cliente. Ela também cria um índice B-tree único. Nulos não contam como repetidos por padrão, por isso duas linhas sem e-mail convivem numa coluna unique, a menos que a restrição declare NULLS NOT DISTINCT.
O check é a restrição mais genérica, segundo a documentação. Ele recebe uma expressão booleana, como preco > 0 ou data_fim > data_inicio. A linha que torna a expressão falsa volta como erro. Uma expressão que resulta em NULL passa pelo check, por isso o not null precisa ser declarado para recusar a ausência de valor. As duas restrições valem também para os valores que vêm de um DEFAULT.
Migrations e a evolução do esquema
A estrutura das tabelas muda junto com o app. Uma coluna nova, uma restrição a mais ou uma tabela de ligação chegam ao banco por migrations, arquivos versionados que as ferramentas do seu framework aplicam em ordem, como as migrations do Laravel e do Prisma. O PostgreSQL não guarda essas versões: ele executa os comandos CREATE TABLE, ALTER TABLE e CREATE INDEX que a migration envia.
O PostgreSQL executa a maior parte desses comandos dentro de uma transação, recurso que o wiki oficial do projeto chama de DDL transacional. Uma migration executada dentro de uma única transação pode desfazer as alterações anteriores com ROLLBACK se algum comando falhar. Alguns comandos ficam fora dessa garantia, como o CREATE DATABASE e o CREATE INDEX CONCURRENTLY, que a documentação não permite dentro de um bloco de transação.
O CONCURRENTLY existe por causa do tempo de escrita parada. Um CREATE INDEX comum segura gravações na tabela até terminar, enquanto a versão concorrente constrói o índice sem impedir INSERT, UPDATE e DELETE, ao custo de uma construção mais lenta. Esse cuidado leva ao próximo assunto, o que um índice faz e como o planejador escolhe usá-lo, na página Índices e planos de consulta.