4D Doc Center : TRUNCATE TABLE

Home

4D v14.3

TRUNCATE TABLE


TRUNCATE TABLE {( Tabellenname )}

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle, in der alle Datensätze auf einmal gelöscht werden, oder Haupttabelle ohne Angabe

Beschreibung

Der Befehl TRUNCATE TABLE löscht alle Datensätze in Tabellenname auf einmal. Nach Aufrufen dieses Befehls gibt es weder eine aktuelle Auswahl noch einen aktuellen Datensatz.

Dieser Befehl arbeitet ähnlich wie die Befehlsfolge ALL RECORDS / DELETE SELECTION; es gibt jedoch folgende Unterschiede:

Es wird kein Trigger aufgerufen.
Die referentielle Integrität der Daten wird nicht geprüft.
Während der Ausführung dieses Befehls darf keine Transaktion ablaufen. In diesem Fall führt der Befehl nichts aus und die Systemvariable OK wird auf 0 (Null) gesetzt.
Sind ein oder mehrere Datensätze durch einen anderen Prozess gesperrt, schlägt der Befehl fehl: Es wird ein Fehler generiert und die Systemvariable OK wird auf 0 (Null) gesetzt. Es wird keine Systemmenge LockedSet erstellt.
Ist Tabellenname bereits leer, führt TRUNCATE TABLE nichts aus und setzt die Variable OK auf 1.
Ist Tabellenname im Nur-Lesen Status, führt TRUNCATE TABLE nichts aus und setzt die Variable OK auf 0.
Gibt es ein Logbuch, wird die Operation darin gespeichert.

Verwenden Sie den Befehl TRUNCATE TABLE mit Bedacht, da er in bestimmten Fällen nachhaltige Wirkung zeigt, wie z.B. rasches Löschen temporärer Dateien.

Hinweis: Dieser Befehl ähnelt im Konzept und in der Funktionsweise dem SQL Befehl TRUNCATE (TABLE).

Systemvariablen und Mengen

Wurde der Befehl korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).