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
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
- Altere 1 linha
- Matched e Changed contam coisas diferentes
Execute a mesma instrução uma segunda vez.
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.
- 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 colunaUNIQUE 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 umUPDATE 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.
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.
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 conditionpara alterar linhas existentes. - Execute o
WHEREcomo umSELECTprimeiro, depois mude apenas o início da instrução. - Leia
Rows matchedeChangedcomo 2 fatos separados. - Separe várias atribuições com vírgulas.
- Espere que um
UPDATEencontre as mesmas regrasUNIQUEeNOT NULLque umINSERT. - Ligue o modo de atualização segura, e leia
ERROR 1175como 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