|
|
|
|
|
|
|
|
|
|
|
version 11.3 (Modifiée)
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.
Référence
SUPPRIMER SELECTION, TRUNCATE.
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.
|
|
|
|
|
|
|
|
|
|
|