Base de Conhecimento

Erro 1290 MySQL: secure-file-priv, como resolver

  • mysql, erro 1290, secure_file_priv, load data, mariadb, into outfile
  • Usuários acharam útil: 0

Entenda o erro 1290 do MySQL, como descobrir a pasta que o servidor aceita, quatro soluções em ordem de segurança e os outros casos, como read_only.

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

Arte da Eleven Host: janela de terminal com o título: Erro 1290 MySQL: secure-file-priv, como resolver

Capa da Redação Eleven Host para o guia: Erro 1290 MySQL: secure-file-priv, como resolver Arte: Eleven Host

O erro 1290 MySQL, The MySQL server is running with the --secure-file-priv option so it cannot execute this statement, aparece quando um LOAD DATA ou um SELECT ... INTO OUTFILE usa uma pasta que o servidor não permite. A saída mais segura é trabalhar na pasta liberada.

Neste guia você vê a mensagem literal, como descobrir qual pasta o servidor aceita, quatro soluções em ordem de segurança e os outros casos em que o mesmo número aparece. Os nomes de banco, tabela e usuário dos exemplos são fictícios.

O que a mensagem do erro 1290 diz

Na referência de erros do MySQL 8.4, o número 1290 tem o símbolo ER_OPTION_PREVENTS_STATEMENT, o SQLSTATE HY000 e esta mensagem:

The MySQL server is running with the %s option so it cannot execute this statement

O %s é trocado pelo nome da opção que bloqueou o comando. Um exemplo de como ela pode aparecer:

ERROR 1290 (HY000): The MySQL server is running with the --secure-file-priv option so it cannot execute this statement

No erro 1290, a causa está escrita na própria mensagem: o nome da opção do servidor que impediu o comando.

O caso mais comum: secure_file_priv

A variável secure_file_priv limita as operações de importação e exportação de arquivos, como as feitas por LOAD DATA, por SELECT ... INTO OUTFILE e pela função LOAD_FILE(). Segundo o manual do MySQL 8.4, essas operações só são permitidas a quem tem o privilégio FILE.

O manual descreve três situações para o valor dela:

  • vazio: a variável não tem efeito, e o manual avisa que esta não é uma configuração segura;
  • nome de uma pasta: o servidor só importa e exporta arquivos dessa pasta, que precisa existir, porque o servidor não a cria;
  • NULL: o servidor desliga a importação e a exportação.

O valor padrão depende da plataforma. Nos pacotes DEB e RPM do MySQL, segundo o manual 8.4, o padrão é /var/lib/mysql-files. Em outras instalações o valor pode ser diferente.

No MariaDB, segundo a documentação, o padrão é None, sem restrição de pasta.

Como ver o valor de secure_file_priv

Entre no cliente e rode uma das duas consultas:

SHOW VARIABLES LIKE 'secure_file_priv';

SELECT @@secure_file_priv;

Um caminho indica a única pasta válida. Vazio indica sem restrição de pasta. NULL indica importação e exportação desligadas, e nenhuma pasta resolve. Com um caminho, as soluções 1 a 3 resolvem sem mexer na configuração do servidor.

Solução 1: usar a pasta permitida

Com o secure_file_priv apontando para uma pasta, o caminho mais seguro é colocar o arquivo nela. Se o valor é /var/lib/mysql-files, um exemplo de importação, com o arquivo já copiado para essa pasta, é este:

LOAD DATA INFILE '/var/lib/mysql-files/clientes.csv' INTO TABLE clientes FIELDS TERMINATED BY ',' IGNORE 1 LINES;

Sem LOCAL, o manual exige o arquivo no servidor e o privilégio FILE na conta. Para exportar, o INTO OUTFILE também usa a pasta permitida. Um exemplo:

SELECT * INTO OUTFILE '/var/lib/mysql-files/pedidos.csv'

FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'

LINES TERMINATED BY '\n'

FROM pedidos;

As quatro linhas formam um único comando. O manual explica que o INTO OUTFILE cria o arquivo no servidor e que o nome não pode ser de um arquivo que já existe, então use um nome novo a cada exportação.

Se a falha for de permissão no banco, o erro é outro. Veja o guia Erro 1044 MySQL: Access denied to database, como resolver.

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

Solução 2: LOAD DATA LOCAL, com os riscos

Com a palavra LOCAL, o arquivo fica na máquina do cliente, não no servidor. O manual do MySQL 8.4 diz que, nesse caso, não é preciso o privilégio FILE e o arquivo pode ficar numa pasta que o programa cliente acesse. Um exemplo:

LOAD DATA LOCAL INFILE 'clientes.csv' INTO TABLE clientes FIELDS TERMINATED BY ',' IGNORE 1 LINES;

No MySQL 8.4, porém, o carregamento local vem desligado: o local_infile do servidor tem o padrão OFF, e o cliente de uma distribuição binária também vem com a função desligada. Ela precisa ser ligada dos dois lados. Se faltar um deles, o erro é outro, o 3950, com a mensagem Loading local data is disabled; this must be enabled on both the client and server side. Não é o 1290.

No servidor, a variável aceita mudança com o banco rodando. Um exemplo:

SET GLOBAL local_infile = ON;

No cliente, a opção --local-infile=1 liga o recurso na conexão. Um exemplo:

mysql --local-infile=1 -u usuario -p loja

No MariaDB o cenário é diferente: segundo a documentação, o padrão do local_infile é ON, e a página do erro 1290 do MariaDB informa que o LOAD DATA LOCAL INFILE não é afetado pelo secure_file_priv.

Os riscos do LOCAL

A página de segurança do MySQL descreve o problema: um servidor adulterado poderia pedir ao cliente um arquivo diferente do citado no comando, e esse servidor acessaria os arquivos da máquina cliente que o usuário consegue ler. A orientação do manual é não conectar a servidores em que você não confia.

Por isso, recomendamos usar o LOCAL só num servidor de confiança, ligar o recurso de propósito para a importação e desligá-lo depois.

Solução 3: exportar pelo cliente ou com mysqldump

Quando o objetivo é só levar dados para fora do banco, dá para evitar o INTO OUTFILE. O manual sugere, para gerar o arquivo em outra máquina, rodar um comando do cliente com mysql -e e redirecionar a saída para um arquivo. Um exemplo:

mysql -u usuario -p -e "SELECT * FROM loja.pedidos" > pedidos.txt

O arquivo é criado na máquina onde você rodou o comando, não no servidor, e a restrição do secure_file_priv não entra na conta. Para uma cópia de um banco inteiro, um exemplo de comando com o mysqldump é este:

mysqldump -u usuario -p loja > loja.sql

Se o problema ao rodar esses comandos for o login do root, veja o guia Erro 1698 MySQL: acesso negado ao root, como resolver.

Solução 4: mudar o secure_file_priv, só em último caso

A variável secure_file_priv não é dinâmica: o SET GLOBAL não funciona nela. Segundo o manual, ela é definida na inicialização do servidor, e a documentação do MariaDB diz que mudar exige reiniciar. Isso significa editar o arquivo de configuração e reiniciar o serviço do banco. Um exemplo no formato do manual:

[mysqld]

secure-file-priv=/var/lib/mysql-files

Antes de reiniciar, confira estes pontos:

  • a pasta precisa existir, porque o servidor não a cria;
  • se o caminho não existir, o servidor registra um erro no log e encerra, e o banco não sobe;
  • o valor vazio desliga a proteção e gera aviso no log, então não use secure-file-priv="" para resolver;
  • o manual considera inseguro um valor que seja a pasta de dados do servidor ou uma subpasta dela.

Em um servidor gerenciado, em que você não controla a configuração, as soluções 1 a 3 são as que sobram.

Outros casos do erro 1290

Como o nome da opção vem na mensagem, o 1290 pode citar outra opção que não a --secure-file-priv. A página do MariaDB sobre esse erro lista quatro opções: --read-only, --secure-file-priv, --skip-grant-tables e --event-scheduler=DISABLED. A seguir, dois deles em seção curta.

Quando a mensagem cita --read-only ou --super-read-only

Segundo o manual do MySQL 8.4, com a variável read_only ligada o servidor não aceita atualizações de clientes, a não ser de quem tem o privilégio CONNECTION_ADMIN (ou o SUPER, que está obsoleto). Com a super_read_only também ligada, nem essas contas escrevem. O manual lembra que a mudança do read_only no servidor de origem não é replicada, e cada réplica pode ter o valor dela.

Se a mensagem do seu erro cita uma dessas opções, o servidor está em modo somente leitura, algo possível numa réplica. O MariaDB orienta rodar a escrita no servidor principal, e não na réplica, e deixa claro que desligar o read_only é decisão do administrador. Para conferir os dois valores:

SELECT @@read_only, @@super_read_only;

Quando a mensagem cita --skip-grant-tables

Essa opção faz o servidor subir sem usar o sistema de privilégios. O manual avisa que ela dá acesso irrestrito aos bancos a quem alcançar o servidor, e por isso o servidor também desliga as conexões remotas. Nesse modo, ele desativa comandos de gestão de contas, como ALTER USER e SET PASSWORD. Num comando desse tipo, a mensagem vai citar a --skip-grant-tables.

Para destravar, o manual manda recarregar as tabelas de permissões, rodar o comando de conta e reiniciar o servidor normalmente, sem a opção:

FLUSH PRIVILEGES;

A documentação chama essa abordagem de menos segura.

Erros parecidos no MySQL

Se a sua mensagem não é a do erro 1290, estes guias cobrem erros vizinhos.

Para o erro de campo sem valor padrão, veja o Erro 1364 MySQL: campo sem valor padrão, como resolver.

Resumo do erro 1290

  • Mensagem: The MySQL server is running with the %s option so it cannot execute this statement, com SQLSTATE HY000.
  • Leitura: o nome da opção na mensagem mostra a causa.
  • Caso comum: secure_file_priv com LOAD DATA ou INTO OUTFILE.
  • Diagnóstico: SELECT @@secure_file_priv;.
  • Soluções, da mais segura para a menos segura: pasta permitida, LOCAL com cuidado, exportar pelo cliente, mudar a configuração com reinício.
  • Outros casos: read_only, super_read_only e skip-grant-tables.

Está comparando servidores VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Perguntas frequentes

O que significa o erro 1290 no MySQL?

É o erro ER_OPTION_PREVENTS_STATEMENT, SQLSTATE HY000. Ele diz que o servidor roda com uma opção que o impede de executar o comando, e o nome da opção aparece na mensagem.

Como resolver o erro 1290 do secure-file-priv?

Consulte o valor com SELECT @@secure_file_priv; e use a pasta que ele mostrar para o arquivo do LOAD DATA ou do INTO OUTFILE.

Posso mudar o secure_file_priv com SET GLOBAL?

Não. A variável não é dinâmica no MySQL nem no MariaDB. A mudança fica no arquivo de configuração, e o servidor precisa ser reiniciado.

O LOAD DATA LOCAL resolve o erro 1290?

Na importação, ele evita a restrição de pasta, porque o arquivo fica no cliente. No MySQL 8.4 vem desligado e exige ativação nos dois lados, e traz os riscos descritos no manual. Sem a ativação, o erro é o 3950.

Deixar o secure_file_priv vazio é uma boa solução?

Não recomendamos. O manual do MySQL diz que o valor vazio não é uma configuração segura, e o servidor grava um aviso no log na inicialização.

Esta resposta lhe foi útil?

Artigos Relacionados