# PostgreSQL INSERT INTO: como inserir linhas

O PostgreSQL `INSERT INTO` é utilizado para adicionar uma ou mais novas linhas a uma tabela. Neste processo, os valores correspondentes também são guardados.

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

Pode utilizar o comando INSERT INTO no PostgreSQL para **inserir novas linhas numa tabela**. É possível inserir apenas uma nova linha, bem como adicionar várias linhas. Ao utilizar `INSERT` no PostgreSQL, também se especificam as colunas previamente definidas ao criar a tabela. Os valores que se pretendem atribuir à nova linha são incluídos no comando.

## PostgreSQL `INSERT`: sintaxe e funcionalidades

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

```postgresql
INSERT INTO nombre_de_tabla (columna1, columna2, columna3, ..., columnaN) 
VALUES (valor1, valor2, valor3, ..., valorN);
```

Ao utilizar `INSERT INTO` no PostgreSQL, deve-se primeiro especificar a tabela na qual se pretende efetuar a seleção. Em seguida, especificam-se as colunas individuais, embora, **teoricamente, seja possível omitir** este parâmetro, desde que sejam utilizados valores para todas as colunas da tabela. Neste caso, a sintaxe é a seguinte:

```postgresql
INSERT INTO nombre_de_tabla 
VALUES (valor1, valor2, valor3, ..., valorN);
```

Em cada caso, os valores individuais devem ser armazenados na ordem correta. Estes são inseridos nas colunas individuais da esquerda para a direita.

## Exemplo do comando PostgreSQL `INSERT INTO`

A melhor forma de ilustrar como a instrução `INSERT INTO` funciona na prática `INSERT INTO` PostgreSQL é através de um exemplo prático. Para tal, utilizamos [a instrução CREATE TABLE do PostgreSQL](https://www.ionos.com/pt-pt/digitalguide/servidores/configuracao/postgresql-create-table/) para criar uma tabela chamada «Lista de clientes». Esta contém quatro colunas denominadas «ID», «Nome», «Cidade» e «Morada». O código correspondente é o seguinte:

```postgresql
CREATE TABLE lista de clientes( 
ID INT PRIMARY KEY NOT NULL, 
Nombre VARCHAR(50) NOT NULL, 
Ciudad VARCHAR(50), 
Dirección VARCHAR(255) 
);
```

Para inserir uma linha, agora usamos o PostgreSQL `INSERT`:

```postgresql
INSERT INTO lista de clientes (ID, NOMBRE, CIUDAD, DIRECCIÓN) 
VALUES (1, 'Sánchez', 'Madrid', 'Gran Vía 1');
```

No exemplo seguinte, não sabemos o endereço de um cliente e deixamos este campo em branco ao introduzi-lo. Isto atribui-lhe o valor predefinido definido na tabela. Se não tiver sido definido nenhum valor, o valor é `NULL`. Eis o código:

```postgresql
INSERT INTO lista de clientes (ID, NOMBRE, CIUDAD) 
VALUES (2, 'Morales', 'Barcelona');
```

## Inserir várias linhas de uma só vez com o PostgreSQL `INSERT`

Também é possível adicionar **várias linhas de uma só vez** no PostgreSQL com `INSERT INTO`. No código seguinte, inserimos mais dois clientes:

```postgresql
INSERT INTO lista de clientes (ID, NOMBRE, CIUDAD, DIRECCIÓN) 
VALUES (3, 'Simón', 'Alicante', 'Calle de la Luna 17'), (4, 'Márquez', 'Sevilla', 'Avenida de los Pinos 73');
```

As linhas individuais devem ser colocadas **entre parênteses e separadas por vírgulas.**

Dica Se quiseres eliminar o conteúdo de uma linha, podes fazê-lo com o comando [DELETE do PostgreSQL](https://www.ionos.com/pt-pt/digitalguide/servidores/configuracao/postgresql-delete/).


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