DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL Client/Serveur
  • Divers
  • Droits nécessaires
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 des informations sur une ou plusieurs sauvegardes effectuées sur un serveur HFSQL Client/Serveur.
Les sauvegardes ont été réalisées grâce à la fonction HSauvegarde (ou via le Centre de Contrôle HFSQL) et peuvent être restaurées par la fonction HRestaureSauvegarde (ou via le Centre de Contrôle HFSQL).
Exemple
// Affiche les informations sur les sauvegardes dans un champ Table
sEtat est une chaîne = HInfoSauvegarde(gcnxConnexion)
sLig est une chaîne
POUR TOUTE CHAÎNE sLig DE sEtat SÉPARÉE PAR EOT
SI sLig ~="" ALORS CONTINUER
TableAjoute(TABLE_Sauvegardes)
nInd est un entier = TableOccurrence(TABLE_Sauvegardes)
TABLE_Sauvegardes.COL_IDSauvegarde[nInd] = ExtraitChaîne(sLig, 1)
TABLE_Sauvegardes.COL_DateHeure[nInd] = ExtraitChaîne(sLig, 2)
TABLE_Sauvegardes.COL_Filtre[nInd] = ExtraitChaîne(sLig, 3)
TABLE_Sauvegardes.COL_Nom[nInd] = ExtraitChaîne(sLig, 4)
TABLE_Sauvegardes.COL_Description[nInd] = ExtraitChaîne(sLig, 5)
TABLE_Sauvegardes.COL_Etat[nInd] = ...
SELON(Val(ExtraitChaîne(sLig, 6)) + 1, "En cours", "Effectuée", "Annulée", "Erreur")
TABLE_Sauvegardes.COL_PourMille[nInd] = ExtraitChaîne(sLig, 7)
FIN
Syntaxe

Informations sur les sauvegardes effectuées sur le serveur Masquer les détails

<Résultat> = HInfoSauvegarde(<Connexion>)
<Résultat> : Chaîne de caractères
Description des sauvegardes réalisées sur le serveur spécifié. Cette description est de la forme :
<Identifiant de la sauvegarde 1> + TAB + <Date de la sauvegarde 1> + TAB +
<Fichiers sauvegardés> + TAB + <Chemin de la destination de la sauvegarde 1> + TAB +
<Description> + TAB + <Etat> + TAB + <Pour mille> + TAB + <Message d'erreur> + TAB +
<Type> + TAB + <Nom du serveur> + TAB + <Identifiant de la sauvegarde complète> + TAB +
<Avec index> + TAB + <Compression> + EOT
où :
  • <Fichiers sauvegardés> est la liste des données sauvegardées séparées par des points virgule (";").
    <Etat> correspond à un entier (ou à une constante de type Entier) permettant de connaître l'état de la sauvegarde :
    hSvgAnnulée2Sauvegarde annulée
    hSvgEnCours0Sauvegarde en cours
    hSvgErreur3Erreur lors de la sauvegarde
    hSvgTerminée1Sauvegarde terminée
  • <Pour mille> correspond au taux de réalisation de la sauvegarde si la sauvegarde est en cours (exprimé en pour mille).
  • <Message d'erreur> est le message d'erreur si la sauvegarde a échoué.
  • <Type> correspond à un entier (ou à une constante de type Entier) permettant de connaître le type de la sauvegarde :
    hSvgComplète0Sauvegarde complète
    hSvgDifférentielle1Sauvegarde différentielle
  • <Identifiant de la sauvegarde complète> correspond à l'identifiant de la sauvegarde complète correspondante dans le cas d'une sauvegarde différentielle.
  • <Nom du serveur> : Nom du serveur de sauvegarde.
  • <Avec index> : Permet de savoir si la sauvegarde contient les index :
    • 0 si la sauvegarde des index n'a pas été effectuée,
    • 1 si la sauvegarde des index a été effectuée.
  • <Compression> : Constante correspondant à la compression de la sauvegarde :
    • zipFormatAucun : la sauvegarde n'est pas compressée.
    • zipFormatZip : la sauvegarde est compressée.
Remarque : le séparateur utilisé entre les différentes descriptions est "EOT" (et non "RC") car les différents paramètres de la description peuvent contenir des Retours Chariot (RC).
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion vers le serveur dont on veut lister les sauvegardes. Cette connexion correspond :

Informations sur une sauvegarde spécifique Masquer les détails

<Résultat> = HInfoSauvegarde(<Connexion> , <Identifiant de la sauvegarde>)
<Résultat> : Chaîne de caractères
Description de la sauvegarde spécifiée sur le serveur spécifié. Cette description est de la forme :
<Identifiant de la sauvegarde 1> + TAB + <Date de la sauvegarde 1> + TAB +
<Fichiers sauvegardés> + TAB + <Chemin de la destination de la sauvegarde 1> + TAB +
<Description> + TAB + <Etat> + TAB + <Pour mille> + TAB + <Message d'erreur> + TAB +
<Type> + TAB + <Nom du serveur> + TAB + <Identifiant de la sauvegarde complète> + TAB + <Avec index> + TAB +
<Compression> + EOT

où :
  • <Fichiers sauvegardés> est la liste des données sauvegardées séparées par des points virgule (";").
    <Etat> correspond à un entier (ou à une constante de type Entier) permettant de connaître l'état de la sauvegarde :
    hSvgAnnulée2Sauvegarde annulée
    hSvgEnCours0Sauvegarde en cours
    hSvgErreur3Erreur lors de la sauvegarde
    hSvgTerminée1Sauvegarde terminée
  • <Pour mille> correspond au taux de réalisation de la sauvegarde si la sauvegarde est en cours (exprimé en pour mille).
  • <Message d'erreur> est le message d'erreur si la sauvegarde a échoué.
    <Type> correspond à un entier (ou à une constante de type Entier) permettant de connaître le type de la sauvegarde :
    hSvgComplète0Sauvegarde complète
    hSvgDifférentielle1Sauvegarde différentielle
  • <Identifiant de la sauvegarde complète> correspond à l'identifiant de la sauvegarde complète correspondante dans le cas d'une sauvegarde différentielle.
  • <Nom du serveur> Nom du serveur de sauvegarde.
  • <Avec index> : Permet de savoir si la sauvegarde contient les index :
    • 0 si la sauvegarde des index n'a pas été effectuée,
    • 1 si la sauvegarde des index a été effectuée.
  • <Compression> : Constante correspondant à la compression de la sauvegarde :
    • zipFormatAucun : la sauvegarde n'est pas compressée.
    • zipFormatZip : la sauvegarde est compressée.
Remarque : le séparateur utilisé entre les différentes descriptions est "EOT" (et non "RC") car les différents paramètres de la description peuvent contenir des Retours Chariot (RC).
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion vers le serveur qui a réalisé la sauvegarde. Cette connexion correspond :
<Identifiant de la sauvegarde> : Entier
Identifiant de la sauvegarde dont on veut obtenir les caractéristiques. Cet identifiant est fourni par la fonction HSauvegarde.
Remarques

Divers

  • La fonction HInfoSauvegarde permet de lister les tâches effectuées ou les tâches en cours. Les tâches planifiées et non effectuées ne sont pas listées.
  • Les sauvegardes réalisées avec le Centre de Contrôle HFSQL et celles réalisées par programmation sont listées.
  • Les dates et heures sont exprimées en temps universel (UTC).

Droits nécessaires

Pour obtenir des informations sur une sauvegarde, l'utilisateur ou le groupe doit posséder :
  • pour chaque base concernée par la sauvegarde, le droit de faire des sauvegardes (constante hDroitSauvegarde) ou le droit de se connecter (constante hDroitConnexion ou hDroitConnexionCryptée).
  • pour une sauvegarde du serveur complet, le droit de faire des sauvegardes (constante hDroitSauvegarde) au niveau du serveur.
Pour savoir si un utilisateur ou un groupe possède ces droits, utilisez la fonction HInfoDroitServeur ou HInfoDroitDaseDeDonnées.
Pour modifier les droits d'un utilisateur ou d'un groupe d'utilisateurs, utilisez la fonction HModifieDroitServeur ou HModifieDroitBaseDeDonnées.
Liste des exemples associés :
WD Duplication Exemples didactiques (WINDEV) : WD Duplication
[ + ] Cet exemple didactique montre comment il est possible de dupliquer une base de données sur un serveur.
La duplication s'effectue par programmation et permet de donner un nouveau nom à la base.
L'exemple s'appuie sur les fonctions de sauvegarde et de restauration de sauvegarde HFSQL.
Composante : wd290hf.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/09/2023

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