DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Réalise diverses statistiques sur les clés d'un fichier de données. 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 <Source>.StatCalcule 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).
Exemple
// Statistiques sur la clé NomCli du fichier de données Client
Client.StatCalcule(NomCli)
Syntaxe
<Résultat> = <Source>.StatCalcule([<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.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données manipulé.
Attention : Ce fichier de données ne doit pas être bloqué par une application.
<Rubrique clé> : Chaîne de caractères optionnelle
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
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 <Source>.StatCalcule ne ferme pas le fichier de données.
  • La mise à jour des statistiques peut également être réalisée par la fonction <Source>.Réindexe. Les fonctions <Source>.Réindexe et <Source>.StatCalcule 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 <Source>.StatCalcule(<Fichier de données>) est équivalente à <Source>.StatCalcule(<Fichier de données>, "*")
  • Pour utiliser la fonction <Source>.StatCalcule 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.
Composante : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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