4D v14.3

VIDER TABLE

Accueil

 
4D v14.3
VIDER TABLE

VIDER TABLE 


 

VIDER TABLE {( laTable )} 
Paramètre Type   Description
laTable  Table in Table de laquelle vous voulez supprimer tous les enregistrements ou Table par défaut si ce paramètre est omis

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.

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : Sélections
Numéro : 1051
Nom intl. : TRUNCATE TABLE

Cette commande modifie la variable système OKCette commande change l'enregistrement courantCette commande change la sélection courante

 
HISTORIQUE 

Modifié : 4D v11 SQL Release 3

 
VOIR AUSSI  

SUPPRIMER SELECTION

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)