Base de Conhecimento

Erro 1227 MySQL: Access denied ao importar, como resolver

  • mysql, erro 1227, access denied, definer, mysqldump, privilégios
  • Usuários acharam útil: 0

Entenda o erro 1227 do MySQL (Access denied; you need at least one of the privileges): como ler a mensagem, as causas em dumps com DEFINER e GTID e como corrigir.

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

Arte da Eleven Host: janela de terminal com o título: Erro 1227 MySQL: Access denied ao importar, como resolver

Capa da Redação Eleven Host para o guia: Erro 1227 MySQL: Access denied ao importar, como resolver Arte: Eleven Host

O erro 1227 MySQL, "Access denied; you need (at least one of) the ... privilege(s) for this operation", aparece quando a conta não tem um privilégio especial exigido pelo comando. A própria mensagem diz qual é. Pode aparecer ao importar um dump com DEFINER ou com comandos de GTID.

Atualizado em 04/11/2026, com base no manual do MySQL 8.4. Veja as causas e como corrigir.

O que a mensagem do erro 1227 diz

No manual do MySQL 8.4, o código 1227 tem o símbolo ER_SPECIFIC_ACCESS_DENIED_ERROR, o SQLSTATE 42000 e a mensagem "Access denied; you need (at least one of) the %s privilege(s) for this operation". O %s vira o nome do privilégio, ou dos privilégios, que faltam à conta que rodou o comando. Segundo o MariaDB, que tem a mesma mensagem para o código 1227, a solução é conceder o privilégio citado ou rodar o comando com uma conta que já o tenha, e o SHOW GRANTS ajuda a conferir o que a conta possui.

O MariaDB também informa que um privilégio de banco ou de tabela não resolve esse erro, porque o privilégio pedido é global.

Como diferenciar o 1227 dos erros parecidos

Vários erros de acesso negado têm mensagens parecidas, mas falam de coisas diferentes. A lista abaixo usa os textos do manual do MySQL 8.4:

  • 1045: "Access denied for user '%s'@'%s' (using password: %s)", SQLSTATE 28000, uma falha de login por usuário, senha ou host. Veja o guia Erro 1698 MySQL: acesso negado ao root, como resolver para um caso de login negado;
  • 1044: "Access denied for user '%s'@'%s' to database '%s'", SQLSTATE 42000, quando falta acesso ao banco;
  • 1142: "%s command denied to user '%s'@'%s' for table '%s'", SQLSTATE 42000, quando falta permissão para um comando numa tabela. O guia Erro 1142 MySQL: comando negado ao usuário, como resolver trata desse caso;
  • 1227: falta um privilégio especial ou administrativo, e o nome dele vem na mensagem.

No erro 1227, a mensagem já entrega a resposta: leia o nome do privilégio que ela cita e descubra qual comando falhou. Só depois decida se concede o privilégio ou muda o comando.

Quais privilégios aparecem na mensagem

O manual do MySQL 8.4 descreve alguns privilégios que podem aparecer nesse erro:

  • SET_ANY_DEFINER: permite indicar outra conta como DEFINER ao criar procedimentos, funções, triggers, eventos e views. Sem ele, só é permitida a conta de quem executa o comando;
  • ALLOW_NONEXISTENT_DEFINER: permite criar objetos cujo DEFINER não existe, os chamados objetos órfãos. Sem ele, a tentativa de criar um procedimento, função ou view órfã dá erro;
  • SYSTEM_VARIABLES_ADMIN: permite mudar variáveis globais com SET GLOBAL e SET PERSIST;
  • SESSION_VARIABLES_ADMIN: permite mudar variáveis de sessão restritas, como sql_log_bin;
  • SUPER: um privilégio amplo, que o manual marca como obsoleto e com remoção prevista numa versão futura;
  • PROCESS: dá acesso às informações sobre as threads em execução.

Uma observação de versão: o privilégio SET_USER_ID, que existia no MySQL 8.0, foi declarado obsoleto no 8.2.0 e removido no 8.4.0. Hoje um GRANT com ele causa erro de sintaxe, e o manual manda usar SET_ANY_DEFINER e ALLOW_NONEXISTENT_DEFINER no lugar.

Situação 1: importar um dump com DEFINER

Esta é a primeira situação a conferir. O manual explica que a definição de um objeto armazenado pode ter o atributo DEFINER, com o nome de uma conta. Quem tem o privilégio SET_ANY_DEFINER pode indicar outra conta. Sem ele, a única conta permitida é a sua própria, escrita por extenso ou como CURRENT_USER. Se a definição omite o DEFINER, o padrão é o usuário que cria o objeto.

Se o dump traz um DEFINER de outra conta e a conta que importa não tem SET_ANY_DEFINER, ela não pode indicar essa outra conta como definer. Um exemplo da página do MariaDB sobre o erro mostra que o comando abaixo falha com a mensagem "you need (at least one of) the SET USER privilege(s) for this operation", porque no MariaDB o privilégio se chama SET USER:

CREATE DEFINER=root@localhost VIEW v2 AS SELECT 1;

Ao reimportar, o manual do mysqldump lembra que você precisa ter os privilégios exigidos pelos comandos que o arquivo contém. Se a conta que importa não tem SET_ANY_DEFINER, há três caminhos: restaurar com uma conta que tenha o privilégio, gerar o dump sem a cláusula DEFINER ou limpar o arquivo antes de importar.

Já considerou um banco de dados na nuvem? Conheça o 11SQL. 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Ver o 11SQL

Como tirar o DEFINER do dump

Atenção: o mysqldump não tem a opção --skip-definer. Ela existia no mysqlpump, que foi declarado obsoleto no MySQL 8.0.34 e removido no 8.4.0. As release notes do 8.4.0 mandam usar o mysqldump ou os utilitários de dump do MySQL Shell.

Pelo MySQL Shell

Nos utilitários de dump do MySQL Shell, a opção compatibility aceita o valor strip_definers. Segundo a documentação do Shell, ela remove a cláusula DEFINER de views, rotinas, eventos e triggers, de modo que os objetos são criados com o definer padrão, o usuário que carrega o esquema, e troca o SQL SECURITY de views e rotinas para INVOKER. O exemplo da página da documentação, que trata de um destino no MySQL HeatWave Service, é (a página não garante o mesmo resultado fora desse contexto, então teste antes):

util.dumpInstance("C:/Users/hanna/worlddump", { ocimds: true, compatibility: ["strip_definers", "strip_restricted_grants"]})

Editando o arquivo do dump

Outra saída é editar o arquivo. Um exemplo de comando para isso, que não vem do manual, usa o sed numa cópia do arquivo. Teste numa cópia do dump e confira o resultado antes de importar:

cp backup.sql backup-sem-definer.sql

sed -i -E 's/DEFINER=`[^`]+`@`[^`]+`//g' backup-sem-definer.sql

grep -c 'DEFINER=' backup-sem-definer.sql

O último comando conta as linhas que ainda têm DEFINER, e o esperado é 0. Lembre que trocar o DEFINER muda com que permissões as views, rotinas e triggers rodam, porque, segundo o manual, os programas armazenados executam com os privilégios da conta indicada. Um DEFINER que não existe cria um objeto órfão, e o manual diz que isso pode ter consequências negativas.

Situação 2: GTID e binlog no dump

O mysqldump controla com a opção --set-gtid-purged a inclusão de um comando SET @@GLOBAL.gtid_purged no arquivo. Essa opção também controla um SET @@SESSION.sql_log_bin=0, que desliga o log binário enquanto o dump é recarregado. O padrão é AUTO: se o servidor de origem tem GTID ativo e o gtid_executed não está vazio, o primeiro comando entra no arquivo.

Esses comandos mexem em variáveis do servidor. O manual diz que mudar uma variável global exige SYSTEM_VARIABLES_ADMIN, ou o SUPER, que está obsoleto, e que a variável de sessão sql_log_bin é restrita e exige SESSION_VARIABLES_ADMIN. Por isso, quem importa com uma conta sem esses privilégios pode, em tese, ver a mensagem pedindo um deles. Os valores da opção são estes:

  • OFF: não inclui nenhum dos dois comandos. O manual diz para usar com um servidor sem GTID, ou com GTID apenas se você tem certeza de que o conjunto necessário já está no gtid_purged do destino, ou se vai tratar os GTIDs que faltam manualmente;
  • COMMENTED: inclui o SET @@GLOBAL.gtid_purged comentado, a menos que o gtid_executed esteja vazio;
  • AUTO: o padrão, descrito acima.

Num dump parcial reaplicado, o manual diz que o comando SET @@GLOBAL.gtid_purged do segundo arquivo falha e que a saída é removê-lo manualmente antes de reaplicar ou gerar o arquivo sem ele. Outro erro que pode aparecer ao importar um dump está no guia Erro 1153 MySQL: max_allowed_packet, como resolver.

Situação 3: funções e triggers com log binário

O manual do MySQL 8.4 diz que, para criar ou alterar uma função armazenada, é preciso ter o SET_ANY_DEFINER, além do CREATE ROUTINE ou ALTER ROUTINE normalmente exigido. A mensagem que o seu servidor devolve informa qual privilégio falta.

Com o log binário ligado, o manual diz que, por padrão, para um CREATE FUNCTION ser aceito, ao menos um entre DETERMINISTIC, NO SQL ou READS SQL DATA deve ser declarado. Sem isso aparece o erro 1418, que pode aparecer junto na importação de funções. Declare a característica correta quando ela for verdadeira para a função. A variável log_bin_trust_function_creators relaxa essas condições, mas é uma variável global, e a própria mensagem do 1418 a chama de menos segura. Recomendamos que só o administrador do servidor mexa nela. Para triggers, o manual diz que as observações sobre funções também valem.

Situação 4: mysqldump pedindo PROCESS

Na hora de gerar o dump, o manual do MySQL 8.4 lista o que o mysqldump exige no mínimo: SELECT nas tabelas, SHOW VIEW nas views, TRIGGER nos triggers, LOCK TABLES se não usar --single-transaction e PROCESS se não usar a opção --no-tablespaces. Com --single-transaction, também pede RELOAD ou FLUSH_TABLES se o gtid_mode e o gtid_purged estiverem como o manual descreve. A opção --no-tablespaces suprime os comandos CREATE LOGFILE GROUP e CREATE TABLESPACE da saída. Se a mensagem pede PROCESS, essa é a saída documentada. Um exemplo de comando:

mysqldump --no-tablespaces -u usuario -p banco > backup.sql

Segundo o manual, o PROCESS permite ver o texto dos comandos em execução, inclusive os que definem ou trocam senhas. Recomendamos conceder privilégios com cuidado.

Roteiro rápido para o erro 1227

  • Leia o nome do privilégio na mensagem e identifique o comando que falhou.
  • Se o comando tem DEFINER, importe com uma conta que tenha SET_ANY_DEFINER ou remova a cláusula do dump, testando numa cópia.
  • Se o dump tem SET @@GLOBAL.gtid_purged, gere de novo com --set-gtid-purged=OFF nas condições do manual.
  • Se pede PROCESS, gere o dump com --no-tablespaces.
  • Se pede privilégio de função, declare a característica correta ou fale com o administrador.
  • Teste primeiro num banco de testes.

Como conceder o privilégio, se for o caso

Se você é o administrador e a conta realmente precisa do privilégio, o manual recomenda dar à conta só os privilégios de que ela precisa e ter cuidado especial com os administrativos. Um exemplo de comando, montado para ilustrar, concede só o privilégio citado na mensagem:

GRANT SET_ANY_DEFINER ON *.* TO 'usuario'@'host';

Troque o nome do privilégio pelo que a sua mensagem cita. Depois, o SHOW GRANTS FOR 'usuario'@'host' mostra se a conta o recebeu. Recomendamos não dar SUPER nem ALL PRIVILEGES a um usuário de aplicação: o manual diz que o SUPER não deve ser concedido de forma leviana.

Resumo para resolver

O erro 1227 indica que falta um privilégio especial e a mensagem diz qual. Descubra o comando que falhou, veja se a causa é DEFINER, GTID, função ou PROCESS e aplique a correção da situação correspondente. Se a importação falhar por outro motivo, veja também o guia Erro 1046 MySQL: No database selected, como resolver.

Já está de olho em alguma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O que significa o erro 1227 no MySQL?

Significa "Access denied; you need (at least one of) the %s privilege(s) for this operation": a conta não tem o privilégio especial que o comando exige, e o nome dele vem na mensagem. O SQLSTATE é 42000.

O mysqldump tem a opção --skip-definer?

Não. Essa opção era do mysqlpump, removido no MySQL 8.4.0. Para tirar o DEFINER, há a opção strip_definers nos utilitários de dump do MySQL Shell (a página da documentação trata de um destino no HeatWave) ou a edição de uma cópia do arquivo.

O que o SET_USER_ID virou no MySQL 8.4?

O SET_USER_ID foi removido no 8.4.0. Use SET_ANY_DEFINER e ALLOW_NONEXISTENT_DEFINER.

Posso dar SUPER para resolver o erro 1227?

Recomendamos conceder só o privilégio citado na mensagem. O manual diz que o SUPER é poderoso, não deve ser concedido de forma leviana e está obsoleto.

Esta resposta lhe foi útil?

Artigos Relacionados