Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

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. 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

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

  1. 3 linhas em 1 instrução

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. 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.
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.
As outras 2 linhas também não entraram.
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.
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.
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 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