4D Doc Center : VIDER TABLE

4D v14.3

VIDER TABLE


VIDER TABLE {( laTable )}

Paramètre	Type	Description
laTable	Table	Table de laquelle vous voulez supprimer tous les enregistrements ou Table par défaut si ce paramètre est omis

Description

La commande VIDER TABLE supprime tous les enregistrements de laTable de façon très rapide. Après l’appel de la commande, il n’y a plus de sélection courante ni d’enregistrement courant.

L’effet de cette commande est semblable à celui d’une séquence TOUT SELECTIONNER / SUPPRIMER SELECTION, toutefois son fonctionnement diffère sur les points suivants :

Le trigger éventuel n'est pas appelé.
L’intégrité référentielle des données n’est pas contrôlée.
Aucune transaction ne doit être en cours dans le process exécutant VIDER TABLE. Si c’est le cas, la commande ne fait rien et la variable système OK prend la valeur 0.
Si un enregistrement au moins est verrouillé par un autre process, la commande échoue : une erreur est générée et la variable OK prend la valeur 0. L’ensemble système LockedSet n’est pas créé.
Si laTable est déjà vide, VIDER TABLE ne fait rien et fixe la variable OK à 1.
Si laTable est en lecture seule, VIDER TABLE ne fait rien et fixe la variable OK à 0.
L’opération est enregistrée dans le fichier d’historique s’il est présent.

La commande VIDER TABLE est donc à manier avec précaution mais est très efficace pour, par exemple, supprimer rapidement des données temporaires.

Note : Le concept et le fonctionnement de cette commande sont proches de ceux de la commande TRUNCATE (TABLE) du SQL.

Variables et ensembles système

Si la commande a été correctement exécutée, la variable système OK prend la valeur 1. Sinon, elle prend la valeur 0.