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 →
Todas as lições até aqui leram dados. 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.
Todas as lições desta seção partem desse estado. Abra o cliente com mysql -u root -p sakila_practice antes de começar, e rode o bloco de novo entre as lições.

Como o INSERT funciona

Substitua 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

  1. Adicionar uma linha

Query OK e 1 row affected é o relatório inteiro. Peça a tabela para ver o que entrou.
A instrução nomeou 4 colunas e a linha tem 6. member_id se incrementou sozinho porque a coluna é AUTO_INCREMENT, e active recebeu o DEFAULT 1 que a tabela declara.

  1. 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 coluna UNIQUE 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.
A mensagem nomeia o valor e o índice que o rejeitou, o que normalmente basta para distinguir uma duplicata de verdade de uma coluna que você pretendia tornar única e não tornou. Upsert é a instrução que espera isso e atualiza a linha existente em vez disso.

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.
Ele nomeia 1 coluna por vez, então uma instrução em que faltam 3 delas leva 3 tentativas. Leia a tabela com 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.
A tentativa com chave duplicada pegou o 6 antes de falhar, e o InnoDB não devolve o número. A tentativa com 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_INCREMENT e deixe o servidor preenchê-la.
  • Leia ERROR 1062 como um valor que uma coluna UNIQUE já tem.
  • Leia ERROR 1364 como 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