Manual MyTable

PostgreSQL • Alterar Tabela

Nesta tela você faz mudanças estruturais em uma tabela do PostgreSQL: renomear tabela, adicionar/renomear/alterar/excluir colunas, ajustar tipo, DEFAULT, NOT NULL, comentários, mover entre schemas e trocar owner. O fluxo é guiado para minimizar erros comuns.

Abrir “Alterar Tabela”

  1. Conecte-se à sua conexão PostgreSQL e selecione o banco.
  2. Escolha o schema e, na árvore, selecione a tabela.
  3. No menu de ações, toque em Alterar Tabela.

Dica: Veja antes a Estrutura da Tabela para confirmar tipos e chaves.

Renomear tabela

  • Informe o novo nome (sem espaços/acentos) e confirme.
  • Atenção: atualize jobs, views e integrações que referenciam o nome antigo.

Adicionar coluna

  1. Toque em Nova Coluna.
  2. Defina nome, tipo, se permite nulo e o DEFAULT (opcional).
  3. (Opcional) Marque como PK ou UNIQUE e adicione comentário.
  4. Salvar.

Boa prática: para colunas obrigatórias em tabelas grandes, crie com DEFAULT, aplique valor às linhas antigas e só então imponha NOT NULL.

Renomear coluna

  • Escolha a coluna, toque em Renomear e informe o novo identificador.
  • Revise views, funções e apps que consumam a coluna.

Alterar tipo de coluna

  1. Selecione a coluna e toque em Alterar Tipo.
  2. Escolha o novo tipo (ex.: INTEGER → BIGINT, TEXT → VARCHAR(150), JSON → JSONB).
  3. Se necessário, informe a conversão (cast/transformação) sugerida pela UI.
  4. Salvar.
  • Valide dado existente: o Postgres pode impedir a mudança se houver valores incompatíveis.
  • Para ajustar precisão/escala de NUMERIC(p,s), garanta que os dados cabem no novo limite.

DEFAULT e NOT NULL

  • DEFAULT: defina valores padrão (ex.: now(), true, gen_random_uuid()).
  • NOT NULL: imponha obrigatoriedade após garantir que não há nulos nas linhas atuais.

Estratégia típica: adicionar coluna com DEFAULT, preencher linhas antigas, depois marcar NOT NULL.

Excluir coluna

  • Selecione a coluna e toque em Excluir.
  • Atenção: a remoção é definitiva; confirme dependências (views, funções, triggers).

Comentários (documentação)

  • Edite o comentário da tabela e de colunas para registrar regras e significado de campos.
  • Os comentários aparecem na Estrutura e facilitam a manutenção.

Mover de schema

  • Toque em Mover para Schema, escolha o destino (ex.: public → financeiro) e confirme.
  • Revise permissões no novo schema (veja Permissões).

Trocar owner (dono)

  • Use Alterar Owner para padronizar administração (ex.: ddl_owner).
  • Mudar owner afeta quem pode conceder privilégios; faça em janela controlada.

Chaves e regras de integridade

Para PK/UNIQUE/FK/CHECK, utilize a tela dedicada: PostgreSQL • Constraints.

  • Ao alterar PK/UK/FK, a UI pode recriar o objeto para refletir a mudança.
  • Verifique impactos em índices e relações — veja também Índices.

Identidade/Sequências

  • Para colunas IDENTITY (ou antigas SERIAL), ajuste o comportamento de geração quando necessário.
  • Após migrações, valide o próximo valor da sequência (ex.: setval) para evitar colisões.

Boas práticas

  • Faça mudanças primeiro em homolog e planeje janela para tabelas grandes.
  • Evite mudanças disruptivas durante horários de pico.
  • Registre alterações relevantes em Logs & Auditoria.
  • Após alterações, rode Analyze para atualizar estatísticas.

Erros comuns (e soluções)

“Tipo incompatível / conversão falhou”

  • Limpe/transforme dados antes de alterar o tipo (ex.: normalizar textos, formatos de data).

“Violação de NOT NULL”

  • Preencha valores nulos existentes ou defina DEFAULT temporário antes de impor a regra.

“Dependência impede exclusão/rename”

  • Revise views/funcões/triggers e atualize-as ou remova a dependência.

“Permissão negada”

  • Garanta privilégios de ALTER na tabela e USAGE no schema (veja Permissões).

Ferramentas relacionadas

Voltar: PostgreSQL • Criar Tabela