PostgreSQL • Estrutura da Tabela

Nesta seção você visualiza a estrutura de uma tabela no PostgreSQL: colunas (tipos, nulos, default), constraints, índices, triggers e outras propriedades. É a base para planejar mudanças com segurança.

Abrir a estrutura

1. Conecte-se à sua conexão PostgreSQL e selecione o banco.
2. Escolha o schema correto (ex.: public).
3. Na árvore, selecione a tabela e toque em Estrutura.

Você verá abas ou seções para Colunas, Constraints, Índices, Triggers e Informações gerais.

Colunas: principais campos

• Nome — identificador da coluna (snake_case recomendado).
• Tipo — ex.: INTEGER, BIGINT, NUMERIC(p,s), TEXT, VARCHAR(n), DATE, TIMESTAMP, BOOLEAN, UUID, JSONB, BYTEA.
• Nulo? — permite NULL ou exige valor (NOT NULL).
• Default — valor padrão (ex.: now() para TIMESTAMP, gen_random_uuid() para UUID).
• Comentário — documentação da coluna (quando disponível).

Para ajustes pontuais em colunas, use as ações de Alterar Campo da sua UI (quando disponível). Para mudanças amplas, siga os fluxos de Alterar Tabela e Constraints.

Constraints (regras de integridade)

• PRIMARY KEY — identifica unicamente cada linha.
• UNIQUE — impede duplicidade (ex.: e-mail).
• FOREIGN KEY — relaciona com outra tabela (consistência referencial).
• CHECK — valida condição (ex.: valor >= 0).
• NOT NULL — exige valor na coluna.

Gerencie em PostgreSQL • Constraints.

Índices

• BTREE — padrão para filtros/ordenações.
• GIN — recomendado para JSONB, ARRAY e full-text (com operadores adequados).
• GiST — útil para geoespacial e similaridade/intervalos.
• BRIN — bom para tabelas enormes com dados naturalmente ordenados (ex.: datas).

Crie e ajuste em PostgreSQL • Índices.

Triggers & Funções

• Triggers — executam lógica em BEFORE/AFTER INSERT/UPDATE/DELETE.
• Funções — código SQL/PLpgSQL chamado por triggers ou consultas.

Gerencie em PostgreSQL • Triggers e consulte funções relacionadas quando necessário.

Comentários, dono e estatísticas

• Owner — usuário proprietário da tabela.
• Comentários — documentação de tabela/colunas (COMMENT ON no PostgreSQL).
• Estimativas de linhas/tamanho — ajudam a avaliar impacto de consultas.

Quando devo alterar a estrutura?

• Nova regra de negócio (ex.: acrescentar coluna, CHECK ou UNIQUE).
• Padronização (tipos/nomes, normalização, NOT NULL com DEFAULT coerente).
• Performance (criar índice adequado, usar JSONB com GIN quando fizer sentido).

Importante: execute primeiro em homolog, com backup e janela de manutenção definida para tabelas grandes.

Erros comuns (e soluções)

“Permissão negada para ver/alterar estrutura”

• Garanta privilégio no schema e na tabela (PostgreSQL separa permissões por objeto).

“Tipo incompatível / conversão falhou”

• Valide se os dados existentes cabem no novo tipo. Para NUMERIC, ajuste precisão/escala.

“Violação de constraint ao alterar”

• Ao impor NOT NULL ou CHECK, corrija dados antigos antes ou defina DEFAULT adequado.

“Queda de performance após mudança”

• Revise índices e rode manutenção/estatísticas quando necessário.

Próximas ações

• Integridade e regras: PostgreSQL • Constraints.
• Desempenho de busca: PostgreSQL • Índices.
• Automação na escrita: PostgreSQL • Triggers.
• Consulta rápida: PostgreSQL • Executar SELECT.

Próximo: PostgreSQL • Constraints • Voltar: PostgreSQL • Visualizar Tabelas