CREATE TABLE name (column type constraints, ...) cria uma tabela. Cada coluna recebe um nome e um tipo de dado e, depois, restrições opcionais como PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE ou CHECK.
A coluna id se numera sozinha, plan usa 'free' quando o insert não informa a coluna, e created_at registra o horário do insert. A página de tipos de dados lista os tipos de coluna mais comuns.
Restrições de coluna
| Restrição | Efeito |
|---|---|
PRIMARY KEY | Única e não nula; uma por tabela |
NOT NULL | A coluna precisa ter um valor |
DEFAULT expr | Valor usado quando um insert omite a coluna |
UNIQUE | Duas linhas não podem ter o mesmo valor (vários NULLs são permitidos) |
CHECK (expr) | Rejeita linhas em que a expressão é falsa |
REFERENCES t (col) | Chave estrangeira para outra tabela |
Desde o PostgreSQL 15, UNIQUE NULLS NOT DISTINCT trata NULLs como iguais, então só uma linha pode ter NULL nessa coluna.
Regras que envolvem várias colunas
Uma restrição sobre mais de uma coluna fica numa linha própria, depois das colunas. Dar um nome com CONSTRAINT name deixa as mensagens de erro legíveis e permite remover a restrição pelo nome depois.
A consulta lista as três restrições. As que não tinham nome receberam nomes gerados, bookings_guests_check e bookings_pkey.
Criar uma tabela só se ela não existir
IF NOT EXISTS transforma o segundo CREATE TABLE num aviso em vez de erro. Ele só verifica o nome. Se já existir uma tabela chamada logs com outras colunas, nada muda.
Criar uma tabela a partir de uma consulta ou de outra tabela
CREATE TABLE ... AS cria uma tabela com o resultado de um SELECT, com as colunas e os tipos desse resultado. LIKE copia a definição de outra tabela sem as linhas, e INCLUDING ALL traz junto os valores padrão, as restrições, a identity e os índices.
big_orders tem uma linha. orders_archive tem as colunas e restrições de orders e nenhuma linha.
Colunas geradas
Uma coluna gerada é calculada a partir de outras colunas da mesma linha, e os inserts não podem gravar nela. No PostgreSQL 17 ela precisa ser STORED: o valor é calculado na escrita e salvo em disco.
Os totais são 13.5 e 20.
Tabelas temporárias e unlogged
CREATE TEMP TABLE cria uma tabela que só a sessão atual enxerga, removida quando a sessão termina. Serve para resultados intermediários num script longo. CREATE UNLOGGED TABLE pula o log de escrita antecipada (WAL), então as escritas ficam mais rápidas. A tabela é esvaziada depois de uma queda e não é copiada para as réplicas, então use só para dados que você consegue reconstruir.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Para alterar uma tabela que já existe, use ALTER TABLE. Todas as opções estão na referência do CREATE TABLE.
Perguntas frequentes
Nomes de tabela diferenciam maiúsculas no PostgreSQL?
Nomes sem aspas viram minúsculas, então CREATE TABLE Users cria users. Um nome entre aspas como "Users" mantém as maiúsculas e precisa ir entre aspas em toda consulta, por isso o normal é usar nomes em minúsculas com snake_case.
Como ver a estrutura de uma tabela no PostgreSQL?
No psql, \d table_name mostra as colunas, os tipos, os valores padrão, os índices e as restrições. Em SQL, consulte information_schema.columns WHERE table_name = 'table_name'.
Como copiar uma tabela no PostgreSQL?
CREATE TABLE copy AS TABLE original; copia as colunas e as linhas, mas não as restrições nem os índices. CREATE TABLE copy (LIKE original INCLUDING ALL); copia a estrutura com valores padrão, restrições e índices, mas sem linhas.
Como apagar uma tabela no PostgreSQL?
DROP TABLE table_name; remove a tabela e seus dados. DROP TABLE IF EXISTS table_name; evita o erro quando ela não existe, e CASCADE remove também as views e chaves estrangeiras que dependem dela.