|
|
|
|
|
|
|
|
|
|
HStatCalcule (Fonction) En anglais : HStatCalculate
  Disponible uniquement avec ces types de connexion
Réalise diverses statistiques sur les clés d'une table.
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 la table. Le moteur HFSQL schéma des données 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 tables. Les statistiques permettent d'avoir des informations sur le contenu de la table au moment de leur calcul. Aussi, plus il y a de modifications de la table après ce calcul et moins ces statistiques sont fidèles au contenu de la table. Plus la table contient d'enregistrements et moins la modification d'un enregistrement a d'impact sur le reflet de la table que les statistiques renvoient. Attention: la fonction HStatCalcule bloque la table en écriture pendant le calcul des statistiques (un parcours de la table est effectué pour chaque clé de la table). Remarque: Pour un calcul de statistiques efficace, il est nécessaire de réaliser ce calcul sur toutes les tables (par exemple dans le cas d'une requête multitable).
HStatCalcule(Client, NomCli)
Syntaxe
<Résultat> = HStatCalcule([<Table> [, <Rubrique clé> [, <Option>]]])
<Résultat> : Booléen - Vrai si le calcul a été effectué,
- Faux en cas de problème (table bloquée par une application par exemple). La fonction HErreur permet d'identifier l'erreur.
<Table> : Chaîne de caractères optionnelle Nom de la table manipulée. Si ce nom n'est pas spécifié, la fonction HStatCalcule 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 est égal à "*" (sans préciser de rubrique), le calcul sera réalisé sur toutes les tables décrites dans le schéma des données en cours (y compris les tables décrites avec les fonctions HDéclare, HDéclareExterne, HDécritTable).
Attention: Cette table ne doit pas être bloquée 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é de la table. <Option> : Constante de type Entier Option de calcul des statistiques. - Si ce paramètre n'est pas précisé, le calcul des statistiques bloque la table en écriture.
- Si ce paramètre correspond à la constante hTâcheDeFond, le calcul des statistiques est effectué en tâche de fond, sans bloquer la table.
Important: Ce paramètre est pris en compte uniquement pour des tables HFSQL Client/Serveur. Dans tous les autres cas, la table est automatiquement bloquée pendant le calcul des statistiques. Remarques - La fonction HStatCalcule ne ferme pas la table.
- 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 de la table.
- Dans les tables HFSQL Classic ou Client/Serveur, seules les rubriques clés peuvent faire l'objet d'un calcul de statistiques.
- La syntaxe HStatCalcule(<Fichier de données>) est équivalente à HStatCalcule(<Fichier de données>, "*")
- 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|