# Tudo sobre o comando PostgreSQL INSERT INTO

O comando PostgreSQL `INSERT INTO` adiciona uma ou mais linhas a uma tabela, assim como os respectivos valores às colunas. Aprenda a usá-lo com os nossos exemplos.

## O que é o comando PostgreSQL `INSERT INTO`?

O comando `INSERT INTO` permite **adicionar linhas em uma tabela** do PostgreSQL. É possível incluir uma ou múltiplas linhas simultaneamente. Ao usar o comando PostgreSQL `INSERT`, é necessário especificar em quais colunas você deseja inserir dados e seus respectivos valores.

## Qual é a sintaxe do comando PostgreSQL `INSERT`?

A sintaxe básica do comando PostgreSQL `INSERT INTO` é a seguinte:

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

Para usar o comando PostgreSQL `INSERT INTO`, é necessário identificar a tabela na qual as linhas serão adicionadas. 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 especificá-las**. A sintaxe ficará assim:

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

A inserção dos valores deve ser feita na ordem correta, correspondendo à sequência das colunas informadas na instrução PostgreSQL `INSERT INTO`.

## Exemplo de uso do comando PostgreSQL `INSERT INTO`

Este é um exemplo de como o comando PostgreSQL `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:

```postgresql
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 PostgreSQL `INSERT INTO`:

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

No exemplo abaixo, não conhecemos 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:

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

### Adicionar múltiplas linhas com o comando PostgreSQL `INSERT INTO`

O PostgreSQL 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:

```postgresql
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 parênteses e separadas por vírgulas.

Dica Se quiser excluir uma linha, use o comando [PostgreSQL `DELETE`](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/postgresql-delete/).


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/postgresql-insert-into/](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/postgresql-insert-into/) for AI/LLM consumption.