Tudo sobre o comando Post­greSQL INSERT INTO

O comando Post­greSQL INSERT INTO adiciona uma ou mais linhas a uma tabela, assim como os res­pec­ti­vos valores às colunas. Aprenda a usá-lo com os nossos exemplos.

O que é o comando Post­greSQL INSERT INTO?

O comando INSERT INTO permite adicionar linhas em uma tabela do Post­greSQL. É possível incluir uma ou múltiplas linhas si­mul­ta­ne­a­mente. Ao usar o comando Post­greSQL INSERT, é ne­ces­sá­rio es­pe­ci­fi­car em quais colunas você deseja inserir dados e seus res­pec­ti­vos valores.

Qual é a sintaxe do comando Post­greSQL INSERT?

A sintaxe básica do comando Post­greSQL INSERT INTO é a seguinte:

INSERT INTO nome_tabela (coluna1, coluna2, coluna3, …, colunaN)
VALUES (valor1, valor2, valor3, …, valorN);

Para usar o comando Post­greSQL INSERT INTO, é ne­ces­sá­rio iden­ti­fi­car a tabela na qual as linhas serão adi­ci­o­na­das. Em seguida, o usuário deve listar as colunas nas quais deseja inserir dados. Se a intenção é adicionar valores a todas as colunas da tabela, não é preciso es­pe­ci­ficá-las. A sintaxe ficará assim:

INSERT INTO nome_tabela
VALUES (valor1, valor2, valor3, …, valorN);

A inserção dos valores deve ser feita na ordem correta, cor­res­pon­dendo à sequência das colunas in­for­ma­das na instrução Post­greSQL INSERT INTO.

Exemplo de uso do comando Post­greSQL INSERT INTO

Este é um exemplo de como o comando Post­greSQL INSERT INTO funciona na prática. Primeiro, vamos criar uma tabela chamada lista_clientes com quatro colunas: id, nome, cidade e endereço. Veja como fazer isso:

CREATE TABLE lista_clientes(
id INT PRIMARY KEY NOT NULL,
nome VARCHAR(50) NOT NULL,
cidade VARCHAR(50),
endereço VARCHAR(255)
);

Para adicionar uma linha à tabela, usaremos o comando Post­greSQL INSERT INTO:

INSERT INTO lista_clientes (id, nome, cidade, endereço)
VALUES (1, 'Sandro', 'Recife', 'Rua Amarela, 123');

No exemplo abaixo, não co­nhe­ce­mos o endereço do cliente. Por isso, vamos omitir esse campo na instrução INSERT INTO. O valor padrão para a tabela será aplicado. Se não houver um padrão definido, o termo NULL será usado. O código ficará assim:

INSERT INTO lista_clientes (id, nome, cidade)
VALUES (2, 'Juliana', 'Palmas');

Adicionar múltiplas linhas com o comando Post­greSQL INSERT INTO

O Post­greSQL também permite adicionar múltiplas linhas de uma vez só usando o comando INSERT INTO. Para inserir dois clientes na tabela ao mesmo tempo, use este código:

INSERT INTO lista_clientes (id, nome, cidade, endereço)
VALUES 
(3, 'William', 'Curitiba', 'Avenida Redonda, 456'), 
(4, 'Bruna', 'Salvador', 'Rua do Mamão, 789');

Note que as linhas foram definidas entre pa­rên­te­ses e separadas por vírgulas.