- Conditions d'utilisation
- Ré-indexation automatique
- Ré-indexation "à chaud"
- Calcul des statistiques
- Répertoire des fichiers temporaires
- Gestion des alphabets non latins
- Droits d'accès au fichier de données
- Cas particulier : Fichiers corrompus après reboot ou erreur fatale du poste
HRéindexe (Fonction) En anglais : HIndex
 Disponible uniquement avec ces types de connexion
SI HRéindexe(UnFichier, hNdxNormal) = Vrai ALORS TableAffiche(TABLE_MaTable, taDébut) FIN
Syntaxe
<Résultat> = HRéindexe([<Fichier de données> [, <Mode> [, <Jauge> [, <Taux de densité>]]]])
<Résultat> : Booléen - Vrai si la ré-indexation a été effectuée sans problème,
- Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : 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 HRéindexe va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H). <Mode> : Constante ou combinaison de constantes de type entier (optionnel) Paramétrage de la ré-indexation : | | hChangeAlphabet | Ré-indexation avec changement d'alphabet. Le nouvel alphabet défini avec la fonction ChangeAlphabet sera pris en compte lors de la ré-indexation. Les tris, recherches, ... sur des clés de type chaîne (chaînes, caractères, date et heure) seront effectués selon cet alphabet. | hFTX | Ré-indexation des index full-text. | Versions 20 et supérieureshMmoCompactage Nouveauté 20hMmoCompactage hMmoCompactage | Compactage et défragmentation des fichiers de type "Mmo". Attention : Cette constante ne peut pas être combinée avec les constantes hNdxCompactage, hFTX, hNdxMinimal, hNdxMuet, hNdxNormal ou hNdxSuppression. | hNdxCompactage | Ré-indexation avec compactage (ne conserve que les enregistrements actifs. Tous les autres enregistrements sont définitivement supprimés). | hNdxMinimal | Ré-indexation ne prenant en compte que les clés corrompues. Ce paramètre est ignoré si les constantes hNdxSuppression ou hNdxCompactage sont activées. | hNdxMuet | Ré-indexation sans affichage | hNdxNormal (valeur par défaut) | Ré-indexation classique (avec statistiques et sans compactage) Les statistiques permettent d'optimiser les requêtes et les filtres (voir Notes) | hNdxSansStat | Ré-indexation sans calcul de statistiques. Cette constante permet d'obtenir un gain de place car les fichiers d'index seront moins importants. Attention : Les statistiques sont très importantes pour obtenir des temps d'exécution corrects lors de l'utilisation de requêtes, de filtres avec condition et de vues avec condition. | hNdxSuppression | Ré-indexation avec suppression des enregistrements endommagés | Versions 15 et supérieureshTâcheDeFond Nouveauté 15hTâcheDeFond hTâcheDeFond | | hVérifieMémo | Ré-indexation normale avec vérification des mémos et correction si nécessaire (permet de récupérer une partie des mémos endommagés). Versions 23 et supérieures Nouveauté 23 | Remarque : La ré-indexation ne compacte pas les mémos. Il est nécessaire d'utiliser WDOptimiseur pour effectuer cette opération (option 5 de WDOptimiseur). <Jauge> : Nom de fenêtre, nom de champ ou entier optionnel - Nom de la fenêtre dans laquelle la jauge doit être affichée,
- Nom du champ de type Jauge affichant la progression de la réindexation,
- Identifiant (Handle) de la fenêtre qui affiche la jauge.
<Taux de densité> : Entier compris entre 1 et 100 Taux de remplissage des index. Par défaut, ce taux a pour valeur 80. Taux de remplissage des index. Par défaut, ce taux a pour valeur 60. Plus ce taux est important, plus l'index est dense et de petite taille. Dans ce cas, les parcours, recherches, filtres et requêtes seront plus rapides. Les ajouts d'enregistrements et les modifications d'enregistrements pourront être ralentis. Plus ce taux est faible, moins l'index sera dense et plus sa taille sera importante. Dans ce cas, les parcours, recherches, filtres et requêtes seront ralentis. Les ajouts d'enregistrements et les modifications d'enregistrements seront plus rapides. Attention : ce paramètre est utilisable uniquement sur les fichiers de données au format HFSQL.
Remarques Conditions d'utilisation - La fonction HRéindexe permet de ré-indexer un fichier xBase.
Versions 21 et supérieuresLa fonction HRéindexe permet de réindexer les fichiers d'un cluster. Dans ce cas : - La réindexation est effectuée sur le noeud auquel l'utilisateur est connecté.
- Seule une réindexation à chaud est disponible (constante hTâcheDeFond).
Nouveauté 21La fonction HRéindexe permet de réindexer les fichiers d'un cluster. Dans ce cas : - La réindexation est effectuée sur le noeud auquel l'utilisateur est connecté.
- Seule une réindexation à chaud est disponible (constante hTâcheDeFond).
La fonction HRéindexe permet de réindexer les fichiers d'un cluster. Dans ce cas : - La réindexation est effectuée sur le noeud auquel l'utilisateur est connecté.
- Seule une réindexation à chaud est disponible (constante hTâcheDeFond).
Calcul des statistiques Le calcul des statistiques permet d'optimiser les requêtes et les filtres sur le fichier de données. Le calcul de statistiques peut également être obtenu par la fonction HStatCalcule. Remarque : Pour que le calcul des statistiques soit 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). Répertoire des fichiers temporaires Pendant la ré-indexation, des fichiers temporaires peuvent être créés. Par défaut, ces fichiers sont créés dans le répertoire temporaire de Windows ou dans le répertoire courant si il n'y a pas assez de place. La variable H.RépertoireTemporaire permet de paramétrer le répertoire utilisé pour stocker ces fichiers temporaires. Cette variable est conseillée notamment lors de la ré-indexation de fichiers de données de taille très importante.
Versions 17 et supérieures Nouveauté 17Gestion des alphabets non latins Pour modifier l'alphabet utilisé pour les recherches, les tris : - Spécifiez l'alphabet à utiliser avec la fonction ChangeAlphabet.
- Ré-indexez le fichier de données avec la fonction HRéindexe. Utilisez la constante hChangeAlphabet pour prendre en compte l'alphabet spécifié avec la fonction ChangeAlphabet.
Pour plus de détails sur la gestion des alphabets non latins dans les fichiers de données, consultez Gérer des alphabets spécifiques dans des fichiers de données. Droits d'accès au fichier de données La ré-indexation provoque la recréation du fichier de données sur disque. Dans un système d'allocation gérant les droits au niveau des fichiers (NTFS, ...), le fichier de données après ré-indexation aura donc les droits du répertoire auquel il appartient. Si avant la ré-indexation, le fichier de données avait des droits particuliers différents de ceux du dossier, il est nécessaire de les redéfinir au niveau de Windows après la ré-indexation. Cas particulier : Fichiers corrompus après reboot ou erreur fatale du poste Lors d'un redémarrage inopiné du poste, les fichiers de données peuvent être corrompus. Dans ce cas, les fichiers de données contiennent des données qui ne correspondent à rien (par exemple caractères illisibles dans les données). Pour corriger ce problème : - Effectuez une ré-indexation avec suppression.
- Libérez les enregistrements en transaction avec la fonction HTransactionLibère.
- Supprimez les enregistrements incorrects à l'aide de WDMAP.
Documentation également disponible pour…
|
|
|