VIDER TABLE

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11.3 (Modifiée)


VIDER TABLE {(laTable)}

ParamètreTypeDescription
laTableTableTable 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.

Référence

SUPPRIMER SELECTION.

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.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant