VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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
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
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.
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 índiceUNIQUE em email recusa.
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.
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,DuplicateseWarningspara confirmar que nada foi ajustado. - Espere que 1 linha rejeitada aborte a instrução inteira e não grave nada.
- Use
INSERT IGNOREpara manter as linhas boas, e leiaSHOW WARNINGSem seguida. - Prefira 1 instrução de várias linhas a muitas instruções de uma linha.
Veja também
- INSERT — a forma de uma linha e os erros que ela produz
- INSERT SELECT — linhas tiradas de uma consulta
- Upsert — atualizar a linha existente em vez de pulá-la
- Inserções em massa no MySQL — tamanhos de lote, LOAD DATA e as configurações que importam