DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HRégénèreTable (Fonction)
En anglais : HRegenerateFile
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Régénère une table à partir de son journal.
Rappel: Lorsque une table journalée est perdue, il est possible de la régénérer à partir de son journal. Il est conseillé pour cela d'utiliser l'outil de maintenance du journal.
Attention: La fonction HRégénèreTable permet de recréer une table à partir de la description du journal.

Cette fonction est réservée à une utilisation avancée. Mal utilisée, cette fonction peut détruire ou corrompre les données.
Exemple
// La table "Client" est journalée.
// La table "Client" se trouve dans le répertoire "C:\Données".
// Le journal de la table "Client.fic" se trouve dans le répertoire "C:\Journal".
// La table "Client" a été détruite.
// Reconstruction de la table à partir du journal
HRégénèreFichier("C:\Journal\ClientJNL.fic", hStructure + hDonnées)
Syntaxe
WINDEVWEBDEV - Code ServeurAjaxHFSQL ClassicHyper File 5.5

Régénération de la table en mode HFSQL Classic Masquer les détails

<Résultat> = HRégénèreTable(<Fichier journal> [, <Mot de passe> [, <Répertoire destination>]] [, <Options> [, <Date et heure de début de restauration> [, <Date et heure limite de restauration> [, <Jauge de restauration> [, <Jauge de réindexation>]]]]])
<Résultat> : Booléen
  • Vrai si la table a été régénérée,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Fichier journal> : Chaîne de caractères
Nom complet du fichier journal à utiliser.
<Mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète
  • Mot de passe de la table journal (identique au mot de passe défini sur la table). Ce mot de passe est obligatoire pour préciser un répertoire de destination.
  • Chaîne vide ("") s'il n'y a pas de mot de passe.
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
<Répertoire destination> : Chaîne de caractères optionnelle
Nom complet du répertoire où sera régénérée la table.
Si ce paramètre n'est pas défini, la table est régénérée dans son répertoire d'origine.
<Options> : Constante ou combinaison de constantes optionnelle
Paramètre la régénération du fichier. Par défaut (aucune option sélectionnée), la fonction n'a aucun effet.
hDonnéesToutes les opérations conservées dans le fichier journal sont appliquées à la table existante. Les données du fichier sont mises à jour avec les données du journal.
hStructureUn nouveau table vide est créé à partir de la description de la table contenue dans le fichier journal. Si la table existe déjà, elle est effacée puis recréée.
<Date et heure de début de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC: AAAA: année, MM: mois, JJ: jour, HH: heure, mm: minutes, SS: secondes, CCC: centièmes de seconde) à partir desquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. La table sera mise à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Date et heure limite de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC: AAAA: année, MM: mois, JJ: jour, HH: heure, mm: minutes, SS: secondes, CCC: centièmes de seconde) jusqu'auxquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. La table sera mise à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Jauge de restauration> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la restauration des données.
<Jauge de réindexation> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la réindexation des données (après leur restauration).
WINDEVWEBDEV - Code ServeurAjaxHFSQL Client/Serveur

Régénération de la table en mode HFSQL Client/Serveur Masquer les détails

<Résultat> = HRégénèreTable(<Connexion> , <Fichier journal> [, <Mot de passe> [, <Répertoire destination>]] [, <Options> [, <Date et heure de début de restauration> [, <Date et heure limite de restauration> [, <Jauge de restauration> [, <Jauge de réindexation>]]]]])
<Résultat> : Booléen
  • Vrai si la table a été régénérée,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Chaîne de caractères
Connexion pour laquelle la base de données doit être regénérée. Cette connexion correspond:
<Fichier journal> : Chaîne de caractères
Nom du fichier journal à utiliser. Le chemin de ce fichier est relatif à la base de données JNL de la connexion (voir Structure des fichiers Journal en mode Client/Serveur).
<Mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète
  • Mot de passe de la table journal (identique au mot de passe défini sur la table). Ce mot de passe est obligatoire pour préciser un répertoire de destination.
  • Chaîne vide ("") s'il n'y a pas de mot de passe.
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
<Répertoire destination> : Chaîne de caractères optionnelle
Nom du répertoire où sera régénérée la table. Ce répertoire est relatif à la base de données définie par la connexion. Si ce paramètre n'est pas défini, la table est régénérée dans son répertoire d'origine.
<Options> : Constante ou combinaison de constantes optionnelle
Paramètre la régénération de la table. Par défaut (aucune option sélectionnée), la fonction n'a aucun effet.
hDonnéesToutes les opérations conservées dans le fichier journal sont appliquées à la table existante. Les données du fichier sont mises à jour avec les données du journal.
hStructureUn nouvelle table vide est créée à partir de la description de la table contenue dans le fichier journal. Si la table existe déjà, elle est effacée puis recréée.
<Date et heure de début de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC: AAAA: année, MM: mois, JJ: jour, HH: heure, mm: minutes, SS: secondes, CCC: centièmes de seconde) à partir desquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. La table sera mise à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Date et heure limite de restauration> : Chaîne de caractères ou variable de type DateHeure optionnelle
Date et heure (au format AAAAMMJJHHmmSSCCC: AAAA: année, MM: mois, JJ: jour, HH: heure, mm: minutes, SS: secondes, CCC: centièmes de seconde) jusqu'auxquelles les opérations présentes dans le fichier journal seront re-jouées sur le fichier de sauvegarde. La table sera mise à jour. Si aucune date et heure n'est précisée, toutes les opérations présentes dans le fichier journal seront effectuées.
<Jauge de restauration> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la restauration des données.
<Jauge de réindexation> : Nom de champ optionnel
Nom du champ Jauge présent dans la fenêtre en cours. Ce champ sera utilisé pour visualiser la progression de la réindexation des données (après leur restauration).
Remarques
La fonction HRégénèreTable peut être utilisée uniquement sur des tables HFSQL (Classic ou Client/Serveur) journalées.
Composante: wd300hf.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/05/2025

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