// MySQL-Fehlerreferenz

MySQL-Fehler 1701: Eine Tabelle mit Fremdschlüsseln kann nicht mit TRUNCATE geleert werden

TRUNCATE TABLE wird abgelehnt, weil eine andere Tabelle einen Fremdschlüssel auf diese verweist, auch wenn keine untergeordneten Zeilen existieren.

Fehlernummer
1701
Name
ER_TRUNCATE_ILLEGAL_FK
SQLSTATE
42000
Kategorie
Schlüssel und Constraints
Fehlermeldung
Cannot truncate a table referenced in a foreign key constraint (%s)

Was es bedeutet

TRUNCATE TABLE löscht die Tabelle und legt sie neu an, statt die Zeilen einzeln zu löschen, sodass InnoDB Fremdschlüssel nicht Zeile für Zeile prüfen kann. Es verweigert das Leeren jeder Tabelle, auf die andere Tabellen verweisen, egal ob untergeordnete Zeilen existieren oder nicht.

Häufige Ursachen

  • Das Leeren einer übergeordneten Tabelle wie customers bei einem Test-Reset oder beim Neuladen von Daten.
  • Tabellen in einer Reihenfolge leeren, bei der übergeordnete vor untergeordneten Tabellen kommen.

Wie du es behebst

  1. Verwende DELETE stattdessen, was Fremdschlüssel (samt Kaskaden) Zeile für Zeile prüft.

    DELETE FROM customers;
  2. Für einen vollständigen Reset der verknüpften Tabellen deaktiviere die Fremdschlüsselprüfungen für die Sitzung, während du alle mit TRUNCATE leerst, und aktiviere die Prüfungen danach wieder.

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

Zugehörige Fehler

Weitere Fehler bei Schlüsseln und Constraints

Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit MySQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für MySQL und die anderen Datenbanken, mit denen du arbeitest.