// Referência de erro do MySQL

Erro do MySQL 1701: não é possível truncar uma tabela com chaves estrangeiras

TRUNCATE TABLE é recusado porque outra tabela possui uma chave estrangeira apontando para esta, mesmo que não existam linhas filhas.

Número do erro
1701
Nome
ER_TRUNCATE_ILLEGAL_FK
SQLSTATE
42000
Categoria
Chaves e restrições
Mensagem de erro
Cannot truncate a table referenced in a foreign key constraint (%s)

O que significa

TRUNCATE TABLE remove e recria a tabela em vez de excluir as linhas uma por uma, então o InnoDB não consegue verificar as chaves estrangeiras linha por linha. Ele se recusa a truncar qualquer tabela que outras tabelas referenciem, independentemente de existirem linhas filhas.

Causas comuns

  • Truncar uma tabela pai como customers em um reset de teste ou recarga de dados.
  • Truncando tabelas em uma ordem onde os pais vêm antes dos filhos.

Como corrigir

  1. Use DELETE em vez disso, o que verifica (e aplica em cascata) chaves estrangeiras linha por linha.

    DELETE FROM customers;
  2. Para zerar tabelas relacionadas por completo, desative as verificações de chaves estrangeiras na sessão enquanto trunca todas e depois reative as verificações.

    SET foreign_key_checks = 0;
    TRUNCATE TABLE order_lines;
    TRUNCATE TABLE orders;
    TRUNCATE TABLE customers;
    SET foreign_key_checks = 1;

Erros relacionados

Mais erros de chaves e restrições

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.