PostgreSQL • Criar Tabela

Use este fluxo para criar uma nova tabela no PostgreSQL sem escrever SQL. Você define colunas, tipos, defaults, NOT NULL, chave primária, comentários e, se quiser, já sai com índices e constraints básicos.

Abrir “Criar Tabela”

1. Conecte-se à sua conexão PostgreSQL e selecione o banco.
2. Escolha o schema de destino (ex.: public).
3. No menu do schema, toque em Criar Tabela.

Identificação da tabela

• Nome: sem espaços/acentos. Sugestão: snake_case (ex.: clientes).
• Schema: onde a tabela será criada.
• (Opcional) Comentário da tabela: descreva objetivo/regra de negócio.

Adicionar colunas

1. Toque em Nova Coluna e preencha:
   • Nome (ex.: cliente_id, nome, email).
   • Tipo (ex.: INTEGER, BIGINT, NUMERIC(12,2), TEXT, VARCHAR(150), DATE, TIMESTAMP, BOOLEAN, UUID, JSONB).
   • Permite nulo? (NOT NULL desmarcado = permite nulo).
   • (Opcional) Default (ex.: now() para TIMESTAMP, true para BOOLEAN, gen_random_uuid() para UUID).
   • (Opcional) Comentário da coluna.
2. Repita para todas as colunas necessárias.

Dica: Para identificadores numéricos, considere BIGINT se prevê muito crescimento.

Chave primária (PK)

• Marque a(s) coluna(s) como PK (pode ser composta).
• Se a PK for numérica gerada automaticamente, escolha:
  • IDENTITY (recomendado nas versões recentes) — gera valores sequenciais.
  • Ou coluna UUID com default gen_random_uuid() (exige extensão pgcrypto em alguns ambientes).

Índices e constraints (opcional na criação)

• Índice Único (UNIQUE) para campos que não podem repetir (ex.: email).
• FOREIGN KEY para relacionar a outra tabela (defina tabela/coluna referenciada e ações ON DELETE/UPDATE — NO ACTION, RESTRICT, CASCADE, SET NULL).
• CHECK para validar regra (ex.: valor >= 0).

Se preferir, você pode criar a tabela simples e depois configurar Constraints e Índices nas telas específicas.

Permissões e owner (opcional)

• Defina o owner (dono) da nova tabela se precisar padronizar administração (ex.: ddl_owner).
• Conceda SELECT/INSERT/UPDATE/DELETE aos grupos adequados. Veja Permissões (Roles & Grants).

Resumo e criação

1. Revise o resumo (nome, schema, colunas, PK, índices/constraints opcionais).
2. Toque em Criar e aguarde a confirmação.
3. A tabela aparecerá na árvore do schema. Você pode abrir Estrutura para conferir.

Boas práticas

• Padronize nomes e tipos (evite abreviações obscuras).
• Marque NOT NULL quando o campo é obrigatório e avalie DEFAULT coerente.
• Evite TEXT para tudo: use VARCHAR(n) quando a regra tiver limite claro.
• Documente com comentários (tabela e colunas) para facilitar manutenção.
• Crie índices para colunas frequentemente filtradas/ordenadas.

Erros comuns (e soluções)

“Nome já existe”

• Escolha outro nome ou crie em outro schema.

“Tipo/Default incompatível”

• Garanta que o default corresponde ao tipo (ex.: datas, numéricos, UUID).

“Sem permissão para criar no schema”

• Conceda USAGE/CREATE no schema ao seu papel (veja Permissões).

“FK inválida”

• Confirme a tabela/coluna de referência e o tipo compatível. Crie a tabela referenciada antes.

Depois de criar

• Carregue dados iniciais (se houver) e rode Analyze para estatísticas.
• Valide CRUD em PostgreSQL • CRUD.
• Se a tabela for crescer muito, avalie Partições desde o desenho.

Ferramentas relacionadas

• Estrutura completa: PostgreSQL • Estrutura da Tabela.
• Integridade: PostgreSQL • Constraints.
• Desempenho: PostgreSQL • Índices.
• Permissões: Roles & Grants.

Próximo: você pode seguir para PostgreSQL • Constraints para amarrar regras ou para PostgreSQL • Índices a fim de otimizar consultas.