PostgreSQL ALTERAR TABELA: Adicionar e Renomear Coluna

Por: Salgueiro-zimbro Salgueiro-zimbro
Hours Atualização do

⚡ Resumo Inteligente

PostgreSQL O comando ALTER TABLE altera a estrutura de uma tabela existente, permitindo adicionar ou remover colunas, renomear uma coluna ou a tabela inteira, definir valores padrão e adicionar restrições de verificação sem recriar o objeto.

  • 🧱 Sintaxe: A ação ALTER TABLE nome-da-tabela executa uma alteração estrutural por instrução.
  • ➕ Adicionar coluna: O comando ADD nome-da-coluna tipo-de-dados adiciona uma nova coluna à tabela.
  • ✏️ Renomear: RENOMEAR COLUNA e RENOMEAR PARA alteram o nome de uma coluna ou o nome de uma tabela.
  • ⚙️ Valor padrão: ALTER COLUMN SET DEFAULT fornece um valor para futuras linhas INSERT.
  • 🛡️ Verificar restrição: A função ADD CHECK valida novos dados e rejeita valores que não atendem à regra.
  • 🤖 Migrações de IA: Assistentes de IA elaboram scripts ALTER TABLE e os revisam para garantir uma implantação segura.
Saiba Mais

PostgreSQL ALTERAR A TABELA

O que é ALTER TABLE em PostgreSQL?

O ALTERAR A TABELA O comando é usado para alterar a estrutura de um PostgreSQL tabela. É o comando usado para alterar as colunas da tabela ou o nome da própria tabela, sem excluir.ping e recriando o objeto.

Sintaxe

Aqui está a sintaxe para o PostgreSQL Comando ALTER TABLE:

ALTER TABLE table-name action;

O parâmetro `table-name` é o nome da tabela que você precisa alterar. O parâmetro `action` é a ação que você precisa executar, como alterar o nome de uma coluna ou alterar o tipo de dados de uma coluna.

Descrição

O comando ALTER TABLE altera a definição de uma tabela existente. Leva os seguintes subformulários:

  • ADICIONE COLUNAEste comando utiliza uma sintaxe semelhante à do comando CREATE TABLE para adicionar uma nova coluna a uma tabela.
  • COLUNA DE DESCARGA: para quedaping uma coluna da tabela. As restrições e os índices impostos às colunas também serão removidos.
  • DEFINIR/DEIXAR PADRÃO: usado para definir ou remover o valor padrão de uma coluna. A alteração só se aplica às colunas subsequentes. Instruções INSERT.
  • SET/DROP NÃO NULO: Altera se uma coluna permitirá valores nulos ou não.
  • ESTATÍSTICAS DO CONJUNTO: para definir a meta de coleta de estatísticas para cada coluna nas operações ANALYZE.
  • DEFINIR ARMAZENAMENTO: para definir o modo de armazenamento de uma coluna, seja em linha ou em uma tabela suplementar.
  • CONJUNTO SEM OIDS: usado para remover a coluna OID antiga da tabela.
  • RENOMEAR: para alterar o nome da tabela ou o nome da coluna.
  • ADICIONAR tabela_constraint: usado para adicionar uma nova restrição a uma tabela. Ele usa a mesma sintaxe que o CRIAR TABELA comando.
  • QUEDA DE RESTRIÇÃO: usado para soltarping uma restrição de tabela.
  • PROPRIETÁRIO: para alterar o proprietário de uma tabela, sequência, índice ou visualização para um determinado usuário.
  • CLUSTER: para marcar uma tabela para ser usada em futuras operações de cluster.

Modificando uma coluna

Uma coluna pode ser modificada de diversas maneiras. Essas modificações são feitas usando o comando ALTER TABLE. Vamos discuti-las a seguir.

Adicionando uma nova coluna

Para adicionar uma nova coluna a um PostgreSQL tabela, o comando ALTER TABLE é usado com a seguinte sintaxe:

ALTER TABLE table-name
  ADD new-column-name column-definition;

O nome da tabela é o nome da tabela a ser modificada. O nome da nova coluna é o nome da nova coluna a ser adicionada. A definição da coluna é a tipo de dados da nova coluna. Veja a tabela Livro mostrada abaixo:

PostgreSQL Exemplo de ALTER TABLE

A tabela possui duas colunas, id e nome. Precisamos adicionar uma nova coluna à tabela e nomeá-la como autor. Basta executar o seguinte comando:

ALTER TABLE Book
  ADD author VARCHAR(50);

Depois de executar o comando acima, a tabela Book agora fica da seguinte forma:

PostgreSQL Exemplo de ALTER TABLE

A nova coluna foi adicionada com sucesso.

Renomeando uma coluna de tabela

Podemos usar o comando ALTER TABLE para alterar o nome de uma coluna. Neste caso, o comando é utilizado com a seguinte sintaxe:

ALTER TABLE table-name
  RENAME COLUMN old-name TO new-name;

O nome da tabela é o nome da tabela cuja coluna será renomeada. O nome antigo é o nome atual da coluna e o novo nome é o novo nome da coluna. Considere a tabela Book mostrada abaixo:

Livro:

PostgreSQL Exemplo de ALTER TABLE

Precisamos alterar o nome da coluna "author" para "book_author". Aqui está o comando:

ALTER TABLE Book
  RENAME COLUMN author TO book_author;

Após executar o comando, podemos visualizar a estrutura da tabela:

PostgreSQL Exemplo de ALTER TABLE

O nome da coluna foi alterado com sucesso.

ARTIGOS RELACIONADOS

Definindo um valor padrão para uma coluna

Podemos definir um valor padrão para uma coluna, de forma que, mesmo quando você não especificar um valor para essa coluna durante as operações de INSERT, o valor padrão será utilizado. Nesse caso, o comando ALTER TABLE pode ser usado com a seguinte sintaxe:

ALTER TABLE table-name ALTER COLUMN column-name [SET DEFAULT value];

O nome da tabela é o nome da tabela cuja coluna será modificada. O nome da coluna é o nome da coluna cujo valor padrão será definido, e o valor é o valor padrão da coluna. Considere a tabela Livro abaixo:

PostgreSQL Exemplo de ALTER TABLE

Precisamos definir um valor padrão para a coluna book_author. Podemos executar o seguinte comando:

ALTER TABLE Book ALTER COLUMN book_author SET DEFAULT 'Nicholas Samuel';

Agora, vamos inserir uma linha na tabela:

INSERT INTO Book (id, name)
 VALUES (6, 'PostgreSQL for Beginners');

Observe que inserimos valores apenas para duas colunas, id e nome. No entanto, o valor padrão foi utilizado para a coluna book_author:

PostgreSQL Exemplo de ALTER TABLE

Adicionando uma restrição de verificação

Uma restrição de verificação ajuda a validar os registros que estão sendo inseridos em uma tabela. Podemos fazer isso combinando o comando ALTER TABLE com a instrução ADD CHECK. Sintaxe:

ALTER TABLE table-name ADD CHECK expression;

O nome da tabela é o nome da tabela a ser alterada e a expressão é a restrição a ser imposta à coluna da tabela. Vamos modificar a coluna book_author da tabela Book para que ela aceite apenas os valores Nicholas e Samuel:

ALTER TABLE Book ADD CHECK (book_author IN ('Nicholas', 'Samuel'));

Agora, vamos tentar inserir um valor diferente de Nicholas ou Samuel na coluna book_author da tabela Book:

INSERT INTO Book
VALUES(7, 'Melhor PostgreSQL Book', 'Gregory Bush');

A instrução retornará o seguinte erro:

PostgreSQL Exemplo de ALTER TABLE

A operação de inserção falhou porque violamos a restrição de verificação.

Renomeando uma tabela

Aqui está a sintaxe do comando ALTER TABLE para renomear uma tabela:

ALTER TABLE table-name
  RENAME TO new-table-name;

O nome-da-tabela é o nome atual da tabela, e o novo-nome-da-tabela é o novo nome a ser atribuído à tabela. Por exemplo, vamos mudar o nome da tabela Livro para Livros:

ALTER TABLE Book
  RENAME TO Books;

Usando pgAdmin

Até agora, as ações foram executadas a partir do shell SQL. Agora, vejamos como essas mesmas ações podem ser realizadas visualmente usando o pgAdmin.

Adicionando uma nova coluna

Passo 1) Faça login em sua conta pgAdmin.

Passo 2)

  1. Na barra de navegação à esquerda, clique em Bancos de dados.
  2. Clique em Demonstração.

PostgreSQL Exemplo de ALTER TABLE

Passo 3) Digite a consulta no editor de consultas:

ALTER TABLE Book
  ADD author VARCHAR(50);

Passo 4) Clique no botão Executar.

PostgreSQL Exemplo de ALTER TABLE

Passo 5) Para verificar se a coluna foi adicionada, faça o seguinte:

  1. Clique em Bancos de dados na navegação esquerda.
  2. Expanda Demonstração.
  3. Expanda Esquemas.
  4. Expanda Público.
  5. Expanda Tabelas.
  6. Expandir livro.
  7. Expanda Colunas.

PostgreSQL Exemplo de ALTER TABLE

A coluna deveria ter sido adicionada, conforme mostrado abaixo:

PostgreSQL Exemplo de ALTER TABLE

Renomeando uma coluna de tabela

Passo 1) Faça login em sua conta pgAdmin.

Passo 2)

  1. Na barra de navegação à esquerda, clique em Bancos de dados.
  2. Clique em Demonstração.

PostgreSQL Exemplo de ALTER TABLE

Passo 3) Digite a consulta no editor de consultas:

ALTER TABLE Book
  RENAME COLUMN author TO book_author;

Passo 4) Clique no botão Executar.

PostgreSQL Exemplo de ALTER TABLE

Passo 5) Para verificar se a alteração foi bem-sucedida, expanda as colunas da tabela de livros como antes:

PostgreSQL Exemplo de ALTER TABLE

As colunas agora devem ser as seguintes:

PostgreSQL Exemplo de ALTER TABLE

A coluna foi alterada com sucesso.

Definindo um valor padrão para uma coluna

Passo 1) Faça login em sua conta pgAdmin.

Passo 2)

  1. Na barra de navegação à esquerda, clique em Bancos de dados.
  2. Clique em Demonstração.

PostgreSQL Exemplo de ALTER TABLE

Passo 3) Digite a consulta no editor de consultas:

ALTER TABLE Book ALTER COLUMN book_author SET DEFAULT 'Nicholas Samuel';

Passo 4) Clique no botão Executar.

PostgreSQL Exemplo de ALTER TABLE

Passo 5) Para testar, execute o seguinte comando no editor de consultas:

INSERT INTO Book (id, name)
 VALUES (6, 'PostgreSQL for Beginners')

Passo 6) Agora podemos consultar a tabela para verificar se o valor padrão foi inserido na coluna book_author:

PostgreSQL Exemplo de ALTER TABLE

Adicionando uma restrição de verificação

Passo 1) Faça login em sua conta pgAdmin.

Passo 2)

  1. Na barra de navegação à esquerda, clique em Bancos de dados.
  2. Clique em Demonstração.

PostgreSQL Exemplo de ALTER TABLE

Passo 3) Digite a consulta no editor de consultas:

ALTER TABLE Book ADD CHECK (book_author IN ('Nicholas', 'Samuel'))

Passo 4) Clique no botão Executar.

PostgreSQL Exemplo de ALTER TABLE

Passo 5) Para testar, digite a seguinte consulta no editor de consultas e clique no botão Executar:

INSERT INTO Book
VALUES(7, 'Melhor PostgreSQL Book', 'Gregory Bush');

PostgreSQL Exemplo de ALTER TABLE

Ele retornará o seguinte:

PostgreSQL Exemplo de ALTER TABLE

Renomeando uma tabela

Passo 1) Faça login em sua conta pgAdmin.

Passo 2)

  1. Na barra de navegação à esquerda, clique em Bancos de dados.
  2. Clique em Demonstração.

PostgreSQL Exemplo de ALTER TABLE

Passo 3) Digite a consulta no editor de consultas:

ALTER TABLE Book
  RENAME TO Books;

Passo 4) Clique no botão Executar.

PostgreSQL Exemplo de ALTER TABLE

Passo 5) Para verificar se a tabela foi renomeada, expanda Bancos de Dados > Demo > Esquemas > Público > Tabelas:

PostgreSQL Exemplo de ALTER TABLE

A tabela foi renomeada com sucesso.

Baixe o banco de dados usado neste tutorial

Perguntas Frequentes

Use ALTER TABLE nome_da_tabela ALTER COLUMN nome_da_coluna TYPE novo_tipo. Adicione uma cláusula USING quando os valores precisarem de conversão, por exemplo, ALTER COLUMN preço TYPE numérico USING preço::numérico. PostgreSQL Reescreve a coluna e verifica se os dados existentes se adequam ao novo tipo.

Somente se o padrão for volátil. Já que PostgreSQL 11. ADICIONAR COLUNA com um valor padrão constante atualiza o catálogo instantaneamente, sem reescrever as linhas. Um valor padrão que chama uma função ainda força uma reescrita completa da tabela e um bloqueio mais forte.

Não. PostgreSQL Não é possível alterar uma restrição já existente. Remova a restrição atual com DROP CONSTRAINT e, em seguida, adicione a restrição corrigida com ADD CONSTRAINT. Envolva ambas as instruções em uma transação para que a tabela nunca fique sem a regra.

Liste várias ações separadas por vírgulas: ALTER TABLE Book ADD COLUMN price int, ADD COLUMN isbn text. PostgreSQL Aplica cada alteração em uma única passagem, o que é mais rápido e mantém a tabela consistente.

Use ALTER TABLE nome_da_tabela ADD PRIMARY KEY (coluna) ou ADD CONSTRAINT nome_da_chave_primária PRIMARY KEY (coluna). A coluna deve conter valores únicos e não nulos; PostgreSQL Constrói automaticamente um índice único de suporte quando a chave é criada.

A operação RENAME atualiza apenas o nome da tabela no catálogo do sistema. As linhas, índices e restrições armazenados permanecem inalterados. Exibições ou funções que fazem referência ao nome antigo ainda podem precisar ser atualizadas posteriormente.

Os assistentes de IA elaboram scripts ALTER TABLE a partir de uma alteração descrita, ordenam corretamente as etapas ADD, RENAME e de restrição e adicionam cláusulas USING para conversões de tipo. Eles também sinalizam operações que reescrevem tabelas grandes ou que mantêm bloqueios complexos.

Sim. Um copiloto de IA analisa uma migração, alerta sobre bloqueios ou reescritas de tabelas inteiras, sugere a criação de índices em lote ou simultâneos e recomenda o encapsulamento.ping alterações em uma transação, tornando as atualizações de esquema mais seguras para implantação.

Resuma esta postagem com: