|
|
|
|
|
|
|
|
|
|
- Divers
- Droits nécessaires
HInfoSauvegarde (Fonction) En anglais : HInfoBackup
 Disponible uniquement avec ce type de connexion
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).
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 - <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ée | 2 | Sauvegarde annulée | | hSvgEnCours | 0 | Sauvegarde en cours | | hSvgErreur | 3 | Erreur lors de la sauvegarde | | hSvgTerminée | 1 | Sauvegarde 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ète | 0 | Sauvegarde complète | | hSvgDifférentielle | 1 | Sauvegarde 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ée | 2 | Sauvegarde annulée | | hSvgEnCours | 0 | Sauvegarde en cours | | hSvgErreur | 3 | Erreur lors de la sauvegarde | | hSvgTerminée | 1 | Sauvegarde 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ète | 0 | Sauvegarde complète | | hSvgDifférentielle | 1 | Sauvegarde 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.
Liste des exemples associés :
|
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.
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|