PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Réalise diverses statistiques sur les clés d'un fichier de données.
Versions 16 et supérieures
Cette fonction est équivalente à la fonction HAccélèreVitesse.
Nouveauté 16
Cette fonction est équivalente à la fonction HAccélèreVitesse.
Cette fonction est équivalente à la fonction HAccélèreVitesse.
Ces statistiques sont utilisées lors de la pose d'un filtre, la création d'une requête ou encore la création d'une vue sur le fichier de données. Le moteur HFSQL analyse la condition de sélection et s'appuie ensuite sur ces statistiques pour déterminer les rubriques les plus discriminantes qui permettront d'optimiser les parcours des fichiers de données.
Les statistiques permettent d'avoir des informations sur le contenu du fichier de données au moment de leur calcul. Aussi, plus il y a de modifications du fichier après ce calcul et moins ces statistiques sont fidèles au contenu du fichier de données. Plus le fichier de données contient d'enregistrements et moins la modification d'un enregistrement a d'impact sur le reflet du fichier de données que les statistiques renvoient.
Attention : la fonction HStatCalcule bloque le fichier de données en écriture pendant le calcul des statistiques (un parcours du fichier de données est effectué pour chaque clé du fichier de données).
HFSQL Client/Serveur Il est possible de réaliser le calcul des statistiques en tâche de fond, sans bloquer le fichier de données en écriture.
Remarque : Pour un calcul de statistiques efficace, il est nécessaire de réaliser ce calcul sur tous les fichiers de données (par exemple dans le cas d'une requête multi-fichiers).
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code Serveur Cette fonction est désormais disponible pour réaliser des statistiques sur les fichiers de données d'un cluster HFSQL.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code Serveur Cette fonction est désormais disponible pour réaliser des statistiques sur les fichiers de données d'un cluster HFSQL.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code Serveur Cette fonction est désormais disponible pour réaliser des statistiques sur les fichiers de données d'un cluster HFSQL.
Versions 22 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 22
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Exemple
// Statistiques sur la clé NOMCLI du fichier CLIENT
HStatCalcule(CLIENT, NOMCLI)
Syntaxe
<Résultat> = HStatCalcule([<Nom du fichier> [, <Nom de la rubrique clé> [, <Option>]]])
<Résultat> : Booléen
  • Vrai si le calcul a été effectué,
  • Faux en cas de problème (fichier de données bloqué par une application par exemple). La fonction HErreur permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données manipulé. Si ce nom n'est pas spécifié, la fonction HStatCalcule va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
Si ce paramètre est égal à "*" (sans préciser de rubrique), le calcul sera réalisé sur tous les fichiers de données décrits dans l'analyse en cours (y compris les fichiers de données décrits avec les fonctions HDéclare, HDéclareExterne, HDécritFichier).
Attention : Ce fichier de données ne doit pas être bloqué par une application.
<Nom de la rubrique clé> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom de la rubrique clé permettant de réaliser les statistiques. Si ce nom n'est pas spécifié ou est égal à "*", le calcul des statistiques sera réalisé sur toutes les rubriques clé du fichier de données.
<Option> : Constante de type Entier
Versions 15 et supérieures
Option de calcul des statistiques.
  • Si ce paramètre n'est pas précisé, le calcul des statistiques bloque le fichier de données en écriture.
  • Si ce paramètre correspond à la constante hTâcheDeFond, le calcul des statistiques est effectué en tâche de fond, sans bloquer le fichier de données.
Important : Ce paramètre est pris en compte uniquement pour des fichiers HFSQL Client/Serveur. Dans tous les autres cas, le fichier de données est automatiquement bloqué pendant le calcul des statistiques.
Nouveauté 15
Option de calcul des statistiques.
  • Si ce paramètre n'est pas précisé, le calcul des statistiques bloque le fichier de données en écriture.
  • Si ce paramètre correspond à la constante hTâcheDeFond, le calcul des statistiques est effectué en tâche de fond, sans bloquer le fichier de données.
Important : Ce paramètre est pris en compte uniquement pour des fichiers HFSQL Client/Serveur. Dans tous les autres cas, le fichier de données est automatiquement bloqué pendant le calcul des statistiques.
Option de calcul des statistiques.
  • Si ce paramètre n'est pas précisé, le calcul des statistiques bloque le fichier de données en écriture.
  • Si ce paramètre correspond à la constante hTâcheDeFond, le calcul des statistiques est effectué en tâche de fond, sans bloquer le fichier de données.
Important : Ce paramètre est pris en compte uniquement pour des fichiers HFSQL Client/Serveur. Dans tous les autres cas, le fichier de données est automatiquement bloqué pendant le calcul des statistiques.
Remarques
  • La fonction HStatCalcule ne ferme pas le fichier de données.
  • La mise à jour des statistiques peut également être réalisée par la fonction HRéindexe. Les fonctions HRéindexe et HStatCalcule sont les deux seules fonctions à mettre à jour les statistiques du fichier de données.
  • Dans les fichiers de données HFSQL Classic ou Client/Serveur, seules les rubriques clés peuvent faire l'objet d'un calcul de statistiques.
  • La syntaxe HStatCalcule(<Nom du fichier>) est équivalente à HStatCalcule(<Nom du fichier>, "*")
  • Versions 21 et supérieures
    Pour utiliser la fonction HStatCalcule avec les fichiers de données d'un cluster HFSQL, le paramètre <Option> doit correspondre à la constante hTâcheDeFond pour ne pas bloquer le cluster.
    Nouveauté 21
    Pour utiliser la fonction HStatCalcule avec les fichiers de données d'un cluster HFSQL, le paramètre <Option> doit correspondre à la constante hTâcheDeFond pour ne pas bloquer le cluster.
    Pour utiliser la fonction HStatCalcule avec les fichiers de données d'un cluster HFSQL, le paramètre <Option> doit correspondre à la constante hTâcheDeFond pour ne pas bloquer le cluster.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220hf.dll
Windows Mobile wp220hf.dll
Java wd220java.jar
Linux wd220hf.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire