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 →
UPDATE altera linhas que já estão lá. O WHERE decide quais, e ele é a única coisa entre 1 linha e a tabela inteira. Estes exemplos usam o banco de dados sakila_practice da lição sobre INSERT. Execute o bloco de configuração de lá novamente antes de começar, depois abra o cliente com mysql -u root -p sakila_practice.

Como UPDATE funciona

Substitua TABLE_NAME pela tabela, COLUMN_NAME pela coluna a alterar, NEW_VALUE pelo que colocar nela, e CONDITION pelo teste que escolhe as linhas. O WHERE funciona exatamente como em um SELECT, e essa é a forma mais segura de escrever um UPDATE: execute-o como um SELECT primeiro, olhe as linhas, depois mude SELECT ... para UPDATE ... SET ... e deixe o WHERE como está.

Exemplos

  1. Altere 1 linha

  1. Matched e Changed contam coisas diferentes

Execute a mesma instrução uma segunda vez.
O WHERE ainda encontrou a linha, então Rows matched é 1. A linha já tinha 0, então nada foi gravado e Changed é 0. Leia os 2 números juntos: matched 0 significa que o WHERE não encontrou nada, que é um problema diferente de changed 0, que significa que você pediu um valor que as linhas já têm.

  1. Altere várias colunas de uma vez

Separe as atribuições com vírgulas, não com AND.

Um UPDATE encontra as mesmas restrições que um INSERT

Mover para uma coluna UNIQUE um valor que outra linha já tem falha da mesma forma, e a linha mantém o que tinha.

Sem um WHERE, ele altera todas as linhas

Não há etapa de confirmação. A instrução é executada e todas as linhas da tabela recebem o novo valor. Uma configuração de sessão pode recusar essa forma por você. O modo de atualização segura rejeita um UPDATE ou um DELETE que não testa uma coluna de chave no seu WHERE nem carrega um LIMIT, e ele fica desligado a menos que você o peça.
Inicie o cliente com mysql -u root -p --safe-updates sakila_practice para ter a proteção desde a primeira instrução. Essa flag faz mais do que definir essa única variável: ela também limita um SELECT a 1.000 linhas por meio de sql_select_limit e restringe um join por meio de max_join_size, então uma leitura de uma tabela grande volta incompleta sem avisar. ERROR 1175 significa que a proteção interrompeu você. Desligue-a novamente quando a instrução realmente deve atingir todas as linhas.
Com a proteção desligada, a instrução é executada.
Rows matched: 3 Changed: 2 porque 1 membro já estava ativo. Uma atualização da tabela inteira às vezes é exatamente o certo. Aumentar todos os saldos em 5% é 1 instrução, e o novo valor é calculado a partir do antigo.
balance = balance * 1.05 lê o valor atual de cada linha, então cada linha recebe sua própria resposta.

Resumo

  • Escreva UPDATE table SET column = value WHERE condition para alterar linhas existentes.
  • Execute o WHERE como um SELECT primeiro, depois mude apenas o início da instrução.
  • Leia Rows matched e Changed como 2 fatos separados.
  • Separe várias atribuições com vírgulas.
  • Espere que um UPDATE encontre as mesmas regras UNIQUE e NOT NULL que um INSERT.
  • Ligue o modo de atualização segura, e leia ERROR 1175 como a proteção fazendo o seu trabalho.

Veja também

  • WHERE — a cláusula que decide quais linhas mudam
  • DELETE — removendo linhas em vez de alterá-las
  • Upsert — atualize uma linha existente, ou insira uma se não houver nenhuma
  • Transações — desfazendo um UPDATE que estava errado