DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Gestion des blocages
  • Fonctions HSécurité et HForceEcriture
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HForceEcriture (Fonction)
En anglais : HFlush
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Force le système d'exploitation du poste sur lequel les tables sont présentes à écrire les données directement sur le disque. Le contexte HFSQL de la table manipulée est conservé (blocage, parcours en cours, ...).
Remarque: Utilisée régulièrement, cette fonction permet de minimiser les pertes de données occasionnées par les arrêts inattendus du poste sur lequel les tables sont présentes (coupure de courant par exemple).
Java Cette fonction est disponible uniquement pour les tables HFSQL. Elle n'est pas disponible pour les tables accédées par JDBC.
Exemple
// Ajout d'un enregistrement dans une table
// (enregistrement décrit par programmation)
Client.Nom = "Moulin"
Client.Prenom = "François"
Client.Adresse = "Impasse de la belle"
Client.Ville = "Montpellier"
Client.CodeP = "34000"
Client.Pays = "France"
HAjoute(Client)
// Force l'écriture dans le fichier Client
HForceEcriture(Client)
Syntaxe
HForceEcriture(<Table>)
<Table> : Chaîne de caractères
Nom de la table manipulée.
Si ce nom n'est pas spécifié, la fonction HForceEcriture va manipuler la dernière table utilisée par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
Si ce paramètre correspond à "*", la fonction HForceEcriture sera appliquée sur l'ensemble des tables ouvertes.
Attention: Dans ce cas, l'exécution de la fonction peut être longue.
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans le schéma des données (non disponible en Android et Android Widget).
Remarques
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadCode Utilisateur (MCU)AjaxHFSQL ClassicHFSQL Client/Serveur

Gestion des blocages

Lors de l'appel de la fonction HForceEcriture, la table manipulée est fermée puis réouverte. Si des blocages étaient mis en place sur cette table avant sa fermeture, ces blocages sont rétablis automatiquement à sa réouverture. En effet, lors de la fermeture d'une table, le système d'exploitation supprime les blocages mis en place sur cette table.
Remarque: Il est donc déconseillé d'appeler cette fonction trop souvent sur:
  • des tables sur lesquelles un grand nombre de blocages est mis en place.
  • des tables sur lesquelles un grand nombre d'écritures est réalisé.

Fonctions HSécurité et HForceEcriture

Les fonctions HSécurité et HForceEcriture permettent toutes les deux de forcer l'écriture physique sur le disque.
Cependant:
  • La fonction HSécurité permet de forcer l'écriture dans la ou les tables manipulées à chaque écriture. Cette écriture est automatiquement réalisée par le moteur HFSQL. Le ou les tables manipulées ne sont pas fermées lors de cette écriture. La vitesse d'écriture dans les tables est plus lente.
  • La fonction HForceEcriture permet de forcer l'écriture dans la ou les tables manipulées uniquement lors de l'appel de cette fonction. Le ou les tables manipulées sont fermées puis ré-ouvertes lors de cette écriture. La vitesse d'écriture dans les tables n'est pas ralentie.
Composante: wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/03/2025

Signaler une erreur ou faire une suggestion | Aide en ligne locale