PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


Nouveauté WINDEV, WEBDEV, WINDEV Mobile 25 !
  • Droits nécessaires pour restaurer une sauvegarde
  • Restauration effectuée depuis le Centre de Contrôle HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Permet de restaurer :
Versions 15 et supérieures
La sauvegarde restaurée peut être une sauvegarde complète ou différentielle.
Nouveauté 15
La sauvegarde restaurée peut être une sauvegarde complète ou différentielle.
La sauvegarde restaurée peut être une sauvegarde complète ou différentielle.
Attention: la restauration d'une sauvegarde doit être effectuée avec précaution.
Pour effectuer cette opération, il est nécessaire d'avoir le droit de sauvegarde (hDroitSauvegarde) ainsi que le droit de bloquer la base de données (hDroitBlocage).
Pour restaurer tout le serveur (ou les bases __jnl et __trs), aucune autre application ne doit être connectée au serveur. La connexion utilisée ne doit pas être attachée à une base de données (lors de l'appel à la fonction <Variable Connexion>.OuvreConnexion, le paramètre <Base de données> doit correspondre à chaîne vide ("")).
Pour restaurer uniquement des bases de données, aucune connexion ne doit être faite sur la base à restaurer.
Dupliquer une base de données : Une syntaxe spécifique de la fonction <Variable Connexion>.RestaureSauvegarde (syntaxe 2) permet de restaurer la sauvegarde d'une base de données sous un nom différent. Il est ainsi possible de faire une copie d'une base en la renommant. Par exemple : pour faire une copie de la base MaBase2008 en la renommant en MaBase2009, il suffit de faire une sauvegarde de MaBase2008 puis de la restaurer sous le nom MaBase2009. Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 22 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 22
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Exemple
cnxServeur est une Connexion
 
// Restauration d'une sauvegarde
SI cnxServeur.RestaureSauvegarde(IDSauvegarde) = Faux ALORS
Erreur("Echec de la restauration de la sauvegarde" + HErreurInfo(hErrMessage))
FIN
cnxServeur est une Connexion
 
// Restauration d'une sauvegarde complète et différentielle
InfoSauvegarde = cnxServeur.InfoSauvegarde(IDSauvegarde)
CheminSauvegarde_Diff = ExtraitChaîne(InfoSauvegarde, 4, TAB)
 
InfoSauvegarde = cnxServeur.InfoSauvegarde(IDSauvegarde_Complète)
CheminSauvegarde_Comp = ExtraitChaîne(InfoSauvegarde, 4, TAB)
 
SI cnxServeur.RestaureSauvegarde(CheminSauvegarde_Comp, CheminSauvegarde_Diff) = Faux ALORS
Erreur("Echec de la restauration de la sauvegarde" + HErreurInfo(hErrMessage))
FIN
Syntaxe

Restauration d'une sauvegarde à partir de son identifiant ou de son chemin Masquer les détails

<Résultat> = <Connexion>.RestaureSauvegarde(<Sauvegarde> [, <Jauge>])
<Résultat> : Booléen
  • Vrai si la restauration de la sauvegarde a été effectuée,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion vers le serveur où la restauration doit être effectuée.
<Sauvegarde> : Entier ou chaîne de caractères
Peut correspondre à :
  • Identifiant de la sauvegarde. Cet identifiant peut correspondre à l'identifiant d'une sauvegarde complète ou d'une sauvegarde différentielle.
    Lors d'une sauvegarde immédiate, cet identifiant est renvoyé par la fonction <Variable Connexion>.Sauvegarde. Cet identifiant peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde.
    Lors d'une sauvegarde planifiée, cet identifiant correspond à la propriété ..Identifiant de la variable hDescriptionSauvegarde.
  • Chemin et nom de la sauvegarde à restaurer. Ce nom a été spécifié lors de la sauvegarde. Ce nom peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde. Si ce nom correspond à un chemin relatif, la sauvegarde sera recherchée dans le sous-répertoire "Backup" du serveur HFSQL. Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
<Jauge> : Nom de fenêtre optionnel, nom de champ optionnel ou entier optionnel
  • Nom de la fenêtre dans laquelle la jauge doit être affichée ou nom du champ de type Jauge.
  • Identifiant (Handle) de la fenêtre qui affiche la jauge.
WEBDEV - Code Serveur Ce paramètre est ignoré.

Restauration d'une sauvegarde sous un nom de base différent Masquer les détails

<Résultat> = <Connexion>.RestaureSauvegarde(<Sauvegarde> , <Base de données source> , <Base de données destination> [, <Jauge>])
<Résultat> : Booléen
  • Vrai si la restauration de la sauvegarde a été effectuée,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion vers le serveur où la restauration doit être effectuée.
<Sauvegarde> : Entier ou chaîne de caractères
Peut correspondre :
  • Identifiant de la sauvegarde renvoyé par la fonction <Variable Connexion>.Sauvegarde. Cet identifiant peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde.
  • Chemin et nom de la sauvegarde à restaurer. Ce nom a été spécifié lors de la sauvegarde. Ce nom peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde. Si ce nom correspond à un chemin relatif, la sauvegarde sera recherchée dans le sous-répertoire "Backup" du serveur HFSQL. Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
<Base de données source> : Chaîne de caractères (avec guillemets)
Nom de la base de données à restaurer présente dans la sauvegarde. Cette syntaxe permet de restaurer une seule base de données présente dans la sauvegarde.
<Base de données destination> : Chaîne de caractères (avec guillemets)
Nom de la base de données qui sera restaurée. Ce nom peut être différent de la base de données source. Dans ce cas, la fonction permet de faire une copie de la base de données avec renommage.
<Jauge> : Nom de fenêtre optionnel, nom de champ optionnel ou entier optionnel
  • Nom de la fenêtre dans laquelle la jauge doit être affichée ou nom du champ de type Jauge.
  • Identifiant (Handle) de la fenêtre qui affiche la jauge.
WEBDEV - Code Serveur Ce paramètre est ignoré.

Restauration d'une sauvegarde différentielle présente dans un répertoire spécifique (disponible à partir de la version 15) Masquer les détails

<Résultat> = <Connexion>.RestaureSauvegarde(<Sauvegarde complète> , <Sauvegarde différentielle> [, <Jauge>])
<Résultat> : Booléen
  • Vrai si la restauration de la sauvegarde a été effectuée,
  • Faux dans le cas contraire. La fonction HErreur permet d'identifier l'erreur.
<Connexion> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion vers le serveur où la restauration doit être effectuée.
<Sauvegarde complète> : Chaîne de caractères (avec guillemets)
Chemin et nom de la sauvegarde complète à restaurer. Ce nom a été spécifié lors de la sauvegarde. Ce nom peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde. Si ce nom correspond à un chemin relatif, la sauvegarde sera recherchée dans le sous-répertoire "Backup" du serveur HFSQL. Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
<Sauvegarde différentielle> : Chaîne de caractères (avec guillemets)
Chemin et nom de la sauvegarde différentielle à appliquer sur la sauvegarde complète. Ce nom a été spécifié lors de la sauvegarde. Ce nom peut également être obtenu grâce à la fonction <Variable Connexion>.InfoSauvegarde. Si ce nom correspond à un chemin relatif, la sauvegarde sera recherchée dans le sous-répertoire "Backup" du serveur HFSQL. Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
<Jauge> : Nom de fenêtre optionnel, nom de champ optionnel ou entier optionnel
  • Nom de la fenêtre dans laquelle la jauge doit être affichée ou nom du champ de type Jauge.
  • Identifiant (Handle) de la fenêtre qui affiche la jauge.
WEBDEV - Code Serveur Ce paramètre est ignoré.
Remarques

Droits nécessaires pour restaurer une sauvegarde

Pour restaurer une sauvegarde, l'utilisateur ou le groupe doit posséder :
  • le droit de faire des sauvegardes (constante hDroitSauvegarde). Ce droit s'applique aux serveurs et aux bases de données.
  • le droit de bloquer la base de données (constante hDroitBlocage). Ce droit s'applique aux bases de données.
Pour savoir si un utilisateur ou un groupe possède ces droits, utilisez la fonction <Variable Connexion>.InfoDroitServeur ou <Variable Connexion>.InfoDroitBaseDeDonné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.

Restauration effectuée depuis le Centre de Contrôle HFSQL

Il est possible de restaurer une sauvegarde depuis le Centre de Contrôle HFSQL. Cette sauvegarde est disponible dans l'onglet "Sauvegardes" de la description du serveur.
Composante : wd250hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire