VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
INSERT os grava. Daqui em diante uma instrução
muda o que está na tabela, então o resto do tutorial trabalha em um banco de dados
próprio em vez de nos dados de exemplo.
Um banco de dados de prática
O Sakila é a referência que todas as lições de leitura descrevem, então deixe-o em paz. Faça um banco de dados pequeno ao lado dele, e rode isto de novo sempre que quiser começar do zero.mysql -u root -p sakila_practice antes de começar, e rode o bloco de novo
entre as lições.
Como o INSERT funciona
TABLE_NAME pela tabela em que você está gravando, COLUMN_LIST pelas
colunas que você está fornecendo, e VALUE_LIST por 1 valor para cada uma dessas
colunas, na mesma ordem.
O servidor adiciona uma linha e relata quantas gravou. Ele não imprime nenhuma linha de volta,
então um SELECT em seguida é como você vê o resultado.
Exemplos
- Adicionar uma linha
Query OK e 1 row affected é o relatório inteiro. Peça a tabela para ver
o que entrou.
member_id se incrementou sozinho
porque a coluna é AUTO_INCREMENT, e active recebeu o DEFAULT 1 que a
tabela declara.
- Ler de volta o id que o servidor escolheu
Um valor AUTO_INCREMENT é decidido durante o insert, então o único jeito de
descobri-lo é perguntar. Pergunte na mesma sessão que fez o insert.
LAST_INSERT_ID() responde só pela sua conexão, então um servidor ocupado não pode
entregar a você o id de outra sessão. Uma conexão nova não tem resposta para dar e
retorna 0.
ERROR 1062 significa que a linha já está lá
Uma colunaUNIQUE recusa uma segunda linha que carregue um valor que ela já tem. Aqui
email é único, e o endereço de Mary Smith já está em uso.
ERROR 1364 significa que uma coluna obrigatória está faltando
Deixe de fora uma coluna que éNOT NULL e não tem valor padrão, e o servidor não tem
nada para gravar.
DESCRIBE member; e forneça tudo que estiver marcado como NO em
Null e não tiver valor padrão.
Uma coluna que aceita NULL é um caso diferente. Deixe-a de fora e a linha recebe
NULL.
Uma chave duplicada ainda consome um id
Peça os ids agora e o 6 está faltando.ERROR 1364 não pegou nada, porque foi recusada
antes de chegar à tabela. Lacunas como essa são normais e não significam que algo foi
perdido. Trate a coluna como um identificador, nunca como uma contagem das linhas ou como uma
promessa de que os números correm sem interrupção.
Resumo
- Escreva
INSERT INTO table (columns) VALUES (values)para adicionar uma linha. - Espere uma contagem de linhas gravadas em vez da linha em si.
- Deixe de fora uma coluna com valor padrão ou
AUTO_INCREMENTe deixe o servidor preenchê-la. - Leia
ERROR 1062como um valor que uma colunaUNIQUEjá tem. - Leia
ERROR 1364como uma coluna obrigatória que você não forneceu. - Espere lacunas em uma coluna
AUTO_INCREMENT, porque uma falha por chave duplicada fica com o número dela.
Veja também
- Inserir várias linhas — 1 instrução, muitas linhas
- INSERT SELECT — linhas de uma consulta em vez de digitadas
- Upsert — inserir, ou atualizar a linha que está no caminho
- UPDATE — mudando uma linha que já está lá