DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL Client/Serveur
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
Renvoie une liste de clés à ajouter aux fichiers de données afin d'améliorer les performances des requêtes.
Exemple
sMaChaîne est une chaîne
sMaChaîne = HSuggèreClé(MaConnexion, ((MaRequête1, MaRequete2, MaRequete3))
Trace(sMaChaîne)
Syntaxe
<Résultat> = HSuggèreClé(<Connexion> , <Requêtes> [, <Options>])
<Résultat> : Chaîne de caractères
Message correspondant au format demandé.
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion vers le serveur HFSQL contenant les requêtes à analyser. Cette connexion correspond :
<Requêtes> : Liste de valeurs entre parenthèses et séparées par des virgules
Liste des requêtes à analyser (10 requêtes maximum). Cette liste de requêtes est de la forme :
(<Requête 1>, ..., <Requête N>)
où :
  • <Requête 1> : Première requête à analyser.
  • ...
  • <Requête N> : Nième requête à analyser.
Remarque : Il est possible d'analyser les requêtes créées avec l'éditeur de requêtes, les requêtes en WLangage ou les requêtes SQL. Les différents types de requêtes peuvent être mélangés dans la liste.
<Options> : Constante de type Entier
Permet de configurer le résultat renvoyé :
hSCSimplifié non précisé
(Valeur par défaut)
<Résultat> correspond à un message lisible, à l'attention du développeur, contenant la liste des clés à ajouter aux fichiers de données pour optimiser les requêtes. Ce texte est au format RTF.
hSCSimplifié précisé<Résultat> correspond à la liste des clés manquantes, et si aucune clé n'est nécessaire, <Résultat> correspond à une chaîne vide. La liste des clés manquantes est de la forme :
<Fichier 1> + TAB + <Clé 1> + <EOT> + <Clé 2> + ...
+ <Clé N> + RC + ... + RC + <Fichier N> + TAB + <Clé 1> +
<EOT> + <Clé 2> + ... + <Clé N>
où :
  • <Fichier N> correspond au fichier de données concerné par l'optimisation.
  • <Clé N> correspond au nom de la clé à ajouter.
Remarques
  • La fonction prend au maximum 10 requêtes en paramètre. Pour prendre en compte plus de requêtes, il est conseillé d'utiliser les fonctions HSuggèreCléDébut et HSuggèreCléFin.
  • Pour analyser une requête paramétrée, il est nécessaire de fournir la valeur du paramètre avant d'exécuter la fonction HSuggèreClé. Par exemple :
    MareqSELECT_PRODUIT est une Requête SQL =
    [
    SELECT * FROM PRODUIT
    WHERE PRODUIT.Reference = {pReference}
    ]
    MareqSELECT_PRODUIT.pReference = 123
    soit sListeclé = HSuggèreClé(MaConnexion, (MareqSELECT_PRODUIT))

    Si aucune valeur n'est donnée pour le ou les paramètres de la requête, la condition de la requête ne sera pas prise en compte. Dans ce cas-là, aucune clé n'est suggérée.
  • Les clés sont suggérées en fonction des données contenues dans le fichier de données. Si un fichier de données ne contient aucune donnée, aucune clé ne sera suggérée.
Classification Métier / UI : Code métier
Composante : wd290hf.dll
Version minimum requise
  • Version 26
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/07/2022

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