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 <Variable Connexion>.Sauvegarde (ou via le Centre de Contrôle HFSQL) et peuvent être restaurées par la fonction <Variable Connexion>.RestaureSauvegarde (ou via le Centre de Contrôle HFSQL).
Exemple
// Description de la connexion
gcnxConnexion est une Connexion

// Affiche les informations sur les sauvegardes dans un champ Table
sEtat est une chaîne = gcnxConnexion.InfoSauvegarde()
sLig est une chaîne
POUR TOUTE CHAÃŽNE sLig DE sEtat SÉPARÉE PAR EOT
SI sLig ~="" ALORS CONTINUER
TABLE_Sauvegardes.Ajoute()
nInd est un entier = TABLE_Sauvegardes.Occurrence()
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> = <Connexion>.InfoSauvegarde()
<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> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion vers le serveur dont on veut lister les sauvegardes.

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

<Résultat> = <Connexion>.InfoSauvegarde(<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> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion vers le serveur qui a réalisé la sauvegarde.
<Identifiant de la sauvegarde> : Entier
Identifiant de la sauvegarde dont on veut obtenir les caractéristiques. Cet identifiant est fourni par la fonction <Variable Connexion>.Sauvegarde.
Remarques

Divers

  • La fonction <Variable Connexion>.InfoSauvegarde 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 <Variable Connexion>.InfoDroitServeur ou HInfoDroitDaseDeDonnées.
Pour modifier les droits d'un utilisateur ou d'un groupe d'utilisateurs, utilisez la fonction <Variable Connexion>.ModifieDroitServeur ou <Variable Connexion>.ModifieDroitBaseDeDonnées.
Composante : wd290hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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