> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQL inserir várias linhas

> Como 1 instrução INSERT do MySQL adiciona muitas linhas, o que a linha Records e Duplicates relata, e por que 1 linha ruim joga a instrução inteira fora.

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

Um `INSERT` pode carregar quantas linhas você quiser. Separe os parênteses de cada linha
com uma vírgula. Isso é menos digitação do que 1 instrução por linha, e é 1 viagem ao
servidor em vez de muitas.

Estes exemplos usam o banco de dados `sakila_practice` de
[INSERT](https://villagesql.com/docs/pt-BR/tutorial/insert.md). Rode o bloco de configuração de lá de novo antes de começar,
depois abra o cliente com `mysql -u root -p sakila_practice`.

## Como um INSERT de várias linhas funciona

```sql theme={null}
INSERT INTO TABLE_NAME (COLUMN_LIST) VALUES
  (FIRST_ROW_VALUES),
  (SECOND_ROW_VALUES);
```

Substitua `TABLE_NAME` pela tabela, `COLUMN_LIST` pelas colunas que você está
fornecendo, e cada um de `FIRST_ROW_VALUES` e `SECOND_ROW_VALUES` por 1 valor
para cada uma dessas colunas.

A lista de colunas é escrita uma vez e governa todas as linhas. Cada par de parênteses
fornece valores nessa ordem.

## Exemplos

### 3 linhas em 1 instrução

```sql theme={null}
INSERT INTO member (first_name, last_name, email, joined) VALUES
  ('Jennifer', 'Davis',  'jennifer.davis@example.com',  '2026-03-18'),
  ('Barbara',  'Jones',  'barbara.jones@example.com',   '2026-03-19'),
  ('Elizabeth','Brown',  'elizabeth.brown@example.com', '2026-03-21');
```

```text theme={null}
Query OK, 3 rows affected (0.00 sec)
Records: 3  Duplicates: 0  Warnings: 0
```

A segunda linha aparece sempre que uma instrução pode gravar mais de 1 linha, o que
cobre uma lista `VALUES` de várias linhas e qualquer
[INSERT SELECT](https://villagesql.com/docs/pt-BR/tutorial/insert-select.md). `Records` conta as linhas que você enviou,
`Duplicates` as linhas que colidiram com uma linha já armazenada, e `Warnings`
qualquer coisa que o servidor teve de ajustar. Os 3 números coincidirem com o que você enviou é o
sinal de que nada foi alterado em silêncio.

```sql theme={null}
SELECT member_id, first_name, last_name FROM member;
```

```text theme={null}
+-----------+------------+-----------+
| member_id | first_name | last_name |
+-----------+------------+-----------+
|         1 | Mary       | Smith     |
|         2 | Patricia   | Johnson   |
|         3 | Linda      | Williams  |
|         4 | Jennifer   | Davis     |
|         5 | Barbara    | Jones     |
|         6 | Elizabeth  | Brown     |
+-----------+------------+-----------+
6 rows in set (0.00 sec)
```

Os ids continuam na ordem em que as linhas foram escritas.

## Uma linha ruim joga a instrução inteira fora

A instrução abaixo carrega 3 linhas. A do meio reutiliza o endereço de Mary Smith,
que o índice `UNIQUE` em `email` recusa.

```sql theme={null}
INSERT INTO member (first_name, last_name, email, joined) VALUES
  ('Maria',  'Miller', 'maria.miller@example.com', '2026-04-02'),
  ('Susan',  'Wilson', 'mary.smith@example.com',   '2026-04-03'),
  ('Margaret','Moore', 'margaret.moore@example.com','2026-04-04');
```

```text theme={null}
ERROR 1062 (23000): Duplicate entry 'mary.smith@example.com' for key 'member.uq_member_email'
```

As outras 2 linhas também não entraram.

```sql theme={null}
SELECT COUNT(*) AS members FROM member;
```

```text theme={null}
+---------+
| members |
+---------+
|       6 |
+---------+
1 row in set (0.00 sec)
```

Uma única instrução é tudo ou nada, então um lote de 10.000 linhas com 1 valor
ruim não grava nada. Tudo ou nada também significa que um lote grande precisa ter os
dados verificados antes de ser enviado, porque o servidor nomeia 1 linha ofensora e
para.

## INSERT IGNORE transforma o erro em um aviso

`INSERT IGNORE` mantém as linhas que consegue e pula o resto.

```sql theme={null}
INSERT IGNORE INTO member (first_name, last_name, email, joined) VALUES
  ('Maria',  'Miller', 'maria.miller@example.com', '2026-04-02'),
  ('Susan',  'Wilson', 'mary.smith@example.com',   '2026-04-03');
SHOW WARNINGS;
```

```text theme={null}
Query OK, 1 row affected, 1 warning (0.00 sec)
Records: 2  Duplicates: 1  Warnings: 1

+---------+------+---------------------------------------------------------------------------+
| Level   | Code | Message                                                                   |
+---------+------+---------------------------------------------------------------------------+
| Warning | 1062 | Duplicate entry 'mary.smith@example.com' for key 'member.uq_member_email' |
+---------+------+---------------------------------------------------------------------------+
1 row in set (0.00 sec)
```

`Records: 2  Duplicates: 1` relata exatamente o que aconteceu: 2 linhas oferecidas, 1
recusada. `SHOW WARNINGS` então a nomeia, e o mesmo texto do `ERROR 1062` chega
como um aviso em vez de uma falha.

```sql theme={null}
SELECT COUNT(*) AS members FROM member;
```

```text theme={null}
+---------+
| members |
+---------+
|       7 |
+---------+
1 row in set (0.00 sec)
```

Use `IGNORE` quando uma duplicata significar de fato "já tenho isso". Fora disso, é um
instrumento grosseiro, porque rebaixa outros erros também, incluindo um valor
longo demais para a coluna e uma linha sem valor para uma coluna obrigatória. Rode
`SHOW WARNINGS` depois de cada `INSERT IGNORE` ou você não vai saber o que ele
descartou. Quando a resposta certa for atualizar a linha já armazenada, use
[upsert](https://villagesql.com/docs/pt-BR/tutorial/upsert.md) em vez disso.

## Resumo

* Separe os parênteses de cada linha com uma vírgula, e escreva a lista de colunas uma vez.
* Leia `Records`, `Duplicates` e `Warnings` para confirmar que nada foi ajustado.
* Espere que 1 linha rejeitada aborte a instrução inteira e não grave nada.
* Use `INSERT IGNORE` para manter as linhas boas, e leia `SHOW WARNINGS` em seguida.
* Prefira 1 instrução de várias linhas a muitas instruções de uma linha.

## Veja também

* [INSERT](https://villagesql.com/docs/pt-BR/tutorial/insert.md) — a forma de uma linha e os erros que ela produz
* [INSERT SELECT](https://villagesql.com/docs/pt-BR/tutorial/insert-select.md) — linhas tiradas de uma consulta
* [Upsert](https://villagesql.com/docs/pt-BR/tutorial/upsert.md) — atualizar a linha existente em vez de pulá-la
* [Inserções em massa no MySQL](https://villagesql.com/docs/pt-BR/guides/bulk-inserts.md) — tamanhos de lote, LOAD DATA e as configurações que importam


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.