|
|
|
|
|
|
|
|
- Droits nécessaires pour restaurer une sauvegarde
- Restauration effectuée depuis le Centre de Contrôle HFSQL
<Variable Connexion>.RestaureSauvegarde (Fonction) En anglais : <Connection variable>.RestoreBackup
 Disponible uniquement avec ce type de connexion
Permet de restaurer : 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.
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
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.
Restauration d'une sauvegarde sous un nom de base de données 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 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 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.
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 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 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.
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.
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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|