Base de Conhecimento

Erro 1175 MySQL: safe update mode, como resolver

  • erro 1175, mysql, safe update mode, sql_safe_updates, workbench, mariadb
  • Usuários acharam útil: 0

Entenda o erro 1175 do MySQL, a proteção do safe update mode contra UPDATE e DELETE sem chave, e veja como resolver pelo caminho seguro, por sessão e no Workbench.

Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Erro 1175 MySQL: safe update mode, como resolver

Capa da Redação Eleven Host para o guia: Erro 1175 MySQL: safe update mode, como resolver Arte: Eleven Host

O erro 1175 MySQL aparece quando um UPDATE ou DELETE roda com o safe update mode ligado e sem usar uma coluna-chave no WHERE nem um LIMIT. É uma proteção, e não um defeito. Veja como resolver, da saída mais segura à menos segura.

Atualizado em 05/11/2026, com base nos manuais do MySQL 8.4 e 9.7, no manual do MySQL Workbench e na documentação do MariaDB. A mensagem do erro, igual no 8.4 e no 9.7, é esta:

You are using safe update mode and you tried to update a table without a WHERE that uses a KEY column. %s

O que o erro 1175 quer dizer

Segundo a referência de erros do MySQL, o código 1175 tem o símbolo ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE e o SQLSTATE HY000. Em português: você está no modo de atualização segura e tentou alterar uma tabela sem um WHERE que use uma coluna-chave. O %s no fim é preenchido com o motivo, que é o primeiro diagnóstico gerado pelo servidor.

O modo é controlado pela variável sql_safe_updates. O manual diz que, com ela ligada, o UPDATE e o DELETE dão erro se não trouxerem uma condição de chave no WHERE, ou um LIMIT, ou os dois. O padrão da variável no servidor é OFF. Quem a liga é o cliente: o programa mysql com a opção --safe-updates (ou -U, ou ainda --i-am-a-dummy, que tem o mesmo efeito) e o MySQL Workbench, onde ela vem ativada por padrão.

O erro 1175 protege contra um UPDATE ou DELETE sem restrição. Resolva primeiro do jeito mais seguro, usando uma chave no WHERE ou um LIMIT, e só depois pense em desligar o modo.

Quando o erro 1175 aparece

O manual mostra dois formatos aceitos no modo seguro. O primeiro usa uma coluna-chave no WHERE, e o segundo usa o LIMIT:

UPDATE tbl_name SET not_key_column=val WHERE key_column=val;

UPDATE tbl_name SET not_key_column=val LIMIT 1;

Um exemplo, com uma tabela fictícia chamada clientes, em que a coluna id é a chave primária e a coluna email não tem índice:

-- Bloqueado: email não tem índice

UPDATE clientes SET ativo = 0 WHERE email = 'a@exemplo.com';

-- Bloqueado: sem WHERE nem LIMIT

DELETE FROM logs;

-- Aceito: id é chave primária

UPDATE clientes SET ativo = 0 WHERE id = 42;

O manual diz também que, em UPDATE e DELETE com mais de uma tabela, o erro só aparece se alguma tabela de destino usar varredura completa (table scan).

Solução 1: use uma coluna-chave no WHERE

É o caminho mais seguro, porque o comando continua limitado às linhas que você quer. Se você só conhece o e-mail, descubra o id antes e use o id no UPDATE. Um exemplo:

SELECT id FROM clientes WHERE email = 'a@exemplo.com';

UPDATE clientes SET ativo = 0 WHERE id = 42;

Troque o 42 pelo id que o SELECT devolveu, e confira se veio uma linha só.

Solução 2: use o LIMIT

O manual também aceita o LIMIT no lugar da chave. Recomendamos escolher o número com cuidado: sem um ORDER BY, não dá para saber quais linhas serão afetadas, e o LIMIT 1 pode mexer numa linha diferente da que você esperava. No MariaDB, trate o LIMIT sozinho como insuficiente, como a seção sobre o MariaDB explica adiante.

Solução 3: desligue só na sua sessão e volte a 1

Se o comando precisa mesmo rodar sem chave, o caminho seguinte é desligar a proteção só na sua sessão, rodar o comando e ligar de novo. Um exemplo, para ajustar ao seu caso:

SET sql_safe_updates = 0;

UPDATE clientes SET ativo = 0 WHERE email = 'a@exemplo.com';

SET sql_safe_updates = 1;

Segundo o manual, a variável de sessão vale para a sua conexão, e a forma explícita é SET SESSION sql_safe_updates = 0;. A última linha, com o valor 1, é parte da solução: recomendamos voltar a proteção assim que o comando terminar, em vez de deixá-la desligada.

Evite o SET GLOBAL para resolver um comando pontual. O manual diz que mudar uma variável global exige privilégios especiais e que a mudança não afeta as sessões já abertas, nem a sua. Por isso, ele não resolve na hora e muda o servidor inteiro.

Solução 4: desligue no MySQL Workbench

No Workbench, a opção Safe Updates, que rejeita UPDATE e DELETE sem restrição, vem habilitada por padrão. A documentação do programa manda abrir as preferências em Edit > Preferences, entrar na seção SQL Editor e desmarcar a opção Safe Updates. Depois, é preciso reconectar ao servidor para a mudança valer.

Como essa preferência é do programa, ela afeta os comandos seguintes que você rodar nele. Recomendamos marcar a opção de novo depois de terminar o serviço.

Outro banco de dados entra na conta? Banco de dados na nuvem, o 11SQL: 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Ver o 11SQL

Erro 1175 mesmo com chave no WHERE

O manual avisa que o erro pode aparecer mesmo com uma chave no WHERE, se o otimizador decidir não usar o índice. Ele dá dois casos:

  • Memória do otimizador. O acesso por intervalo no índice não pode ser usado se a memória passar do que a variável range_optimizer_max_mem_size permite. O otimizador então volta para a varredura completa da tabela. O valor 0 significa sem limite. Fora do modo seguro, o aviso é o 3170, que diz que a capacidade de memória foi excedida e que a otimização de intervalo não foi feita;
  • Conversão de tipo. Se a comparação de chaves exige conversão de tipo, o índice pode não ser usado. O manual dá o exemplo de uma coluna de texto indexada, c1, comparada com um número, como em WHERE c1 = 2222. Com o modo seguro ligado, ocorre o erro.

A página sobre a otimização de intervalo explica o motivo: se o otimizador cai na varredura completa e a variável está ligada, o MySQL dá erro em vez de aviso, porque, na prática, nenhuma chave determina as linhas a modificar. Para o caso do tipo, recomendamos comparar a coluna de texto com um valor de texto, como '2222'.

Para investigar, o manual diz que o EXPLAIN com UPDATE e DELETE não produz o erro do modo seguro. Um exemplo, para rodar com o SHOW WARNINGS logo depois:

EXPLAIN UPDATE clientes SET ativo = 0 WHERE email = 'a@exemplo.com';

SHOW WARNINGS;

Os outros limites do --safe-updates

A opção --safe-updates do cliente mysql não liga só a variável do erro 1175. Ao conectar, ela executa este comando, segundo o manual:

SET sql_safe_updates=1, sql_select_limit=1000, max_join_size=1000000;

O sql_select_limit=1000 faz o servidor limitar os resultados de SELECT a 1.000 linhas, a menos que o comando traga um LIMIT. O max_join_size=1000000 faz um SELECT com várias tabelas dar erro se o servidor estimar mais de 1.000.000 de combinações de linhas. Para mudar os valores, o manual dá este exemplo:

mysql --safe-updates --select-limit=500 --max-join-size=10000

Se a opção está num arquivo de opções, a documentação indica --skip-safe-updates na linha de comando para desfazê-la.

Antes de mexer: backup e transação

Alteração em massa pede cuidado. Recomendamos fazer um backup da tabela antes. Um exemplo de comando, com nomes fictícios, para ajustar ao seu servidor:

mysqldump -u usuario -p banco clientes > clientes.sql

O manual descreve a transação assim: o START TRANSACTION ou o BEGIN inicia uma nova transação, o COMMIT torna as mudanças permanentes e o ROLLBACK cancela as mudanças. Um exemplo de uso:

START TRANSACTION;

SELECT COUNT(*) FROM clientes WHERE email = 'a@exemplo.com';

UPDATE clientes SET ativo = 0 WHERE email = 'a@exemplo.com';

-- confira as linhas afetadas; se estiver certo:

COMMIT;

-- se estiver errado, no lugar do COMMIT: ROLLBACK;

O ROLLBACK tem limites

Recomendamos não tratar o ROLLBACK como garantia. Ele desfaz apenas o que o motor de armazenamento da tabela sabe desfazer em transação, e há comandos que encerram a transação sozinhos, com o chamado commit implícito. Confira o motor da tabela e o manual da sua versão, e mantenha o backup.

E no MariaDB?

O MariaDB tem o mesmo erro 1175, com o SQLSTATE HY000 e o símbolo ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE. O cliente mariadb tem a opção -U ou --safe-updates, e o --i-am-a-dummy é um sinônimo. Ao conectar, ele executa este comando, em que o nome do último limite muda:

SET sql_safe_updates=1, sql_select_limit=1000, sql_max_join_size=1000000;

Repare que a variável é sql_max_join_size no MariaDB e max_join_size no MySQL. Para mudar os limites, a sintaxe é mariadb --safe-updates --select_limit=500 --max_join_size=10000. A variável sql_safe_updates tem escopo global e de sessão, é dinâmica, booleana e tem padrão OFF.

O texto da regra também difere. A descrição do MariaDB diz que o UPDATE e o DELETE precisam usar um índice, ou mencionar uma coluna indexada e especificar um LIMIT. A frase do MySQL, por sua vez, aceita a chave ou o LIMIT. Por isso, no MariaDB, não conte com o LIMIT sozinho: prefira a coluna indexada no WHERE e confira no seu servidor. Para entender as diferenças entre os dois bancos, veja o guia MySQL ou MariaDB.

Se a mensagem trouxer outro número

O erro 1175 é só o da atualização sem chave. Se o seu comando falhou por outro motivo, a causa é outra: para campo sem valor padrão, veja o erro 1364 MySQL; para dado grande demais para a coluna, o erro 1406 MySQL; e para data inválida, o erro 1292 MySQL.

Para quem vai escolher um servidor

A loja mostra os planos de VPS e o que cada um inclui.

Mais um servidor entra no orçamento? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Perguntas frequentes

O que é o erro 1175 no MySQL?

É a mensagem de que o safe update mode está ligado e o UPDATE ou DELETE não usou uma coluna-chave no WHERE nem um LIMIT. É uma proteção documentada, com SQLSTATE HY000.

O servidor MySQL vem com o modo seguro ligado?

Não. O padrão da variável sql_safe_updates é OFF. Quem liga o modo é o MySQL Workbench, por padrão, ou o cliente mysql com a opção --safe-updates.

Colocar um WHERE faz o erro 1175 sumir?

Não. O WHERE precisa usar uma coluna-chave, ou o comando precisa ter um LIMIT. E o manual dá dois casos em que o erro continua mesmo com a chave: a memória do otimizador e a conversão de tipo.

Posso desligar o modo seguro de vez?

Recomendamos desligar só na sessão e voltar o valor a 1 em seguida. O SET GLOBAL exige privilégios especiais e não afeta as sessões já abertas.

O ROLLBACK desfaz um UPDATE já feito?

Só se o UPDATE ainda estiver dentro de uma transação aberta, sem COMMIT, e se o motor de armazenamento da tabela desfizer transações. Depois do COMMIT ou de um commit implícito, não. Por isso, recomendamos o backup antes.

Esta resposta lhe foi útil?

Artigos Relacionados