Définition des options de restauration VSS

Les options de restauration permettent aux demandeurs de communiquer des options de restauration personnalisées aux enregistreurs.

Options de restauration

La normalisation du format des options de restauration permet aux rédacteurs et aux demandeurs de gérer les demandes personnalisées courantes. Les options de restauration sont définies par le demandeur en appelant la méthode IVssBackupComponents::SetRestoreOptions jusqu’à une fois par composant selected-for-backup avant d’appeler la méthode IVssBackupComponents::P reRestore . La chaîne passée dans le paramètre wszRestoreOptions à la méthode SetRestoreOptions peut contenir plusieurs valeurs, comme décrit ci-dessous.

Format

Le format des options de restauration est une ou plusieurs paires nom/valeur séparés par des virgules, et le nom est éventuellement précédé du nom du sous-composant auquel il s’applique. Les noms des composants et des options ne respectent pas la casse. Le respect de la casse des valeurs est déterminé par l’enregistreur. Exemple :

"Child1":"Option1"="Value1","Option2"="Value2","Child2\Grandchild3":"Option3"="Value3"

Dans cet exemple, « Option1 » s’applique uniquement au sous-composant « Child1 » et à ses descendants, « Option2 » s’applique à tous les composants et à leurs descendants, et « Option3 » s’applique uniquement aux sous-composants « Child2\Grandchild3 » et à ses descendants.

La méthode SetRestoreOptions ne peut être appelée que sur les composants qui peuvent être sélectionnés pour la sauvegarde, tandis que les nœuds descendants peuvent ne pas être sélectionnables pour la sauvegarde, ils peuvent être sélectionnés pour la restauration.

Options de restauration courantes

Ces options de restauration courantes ont été définies pour augmenter l’interopérabilité entre les auteurs et les demandeurs.

• Faisant autorité

  L’option « Faisant autorité » prend en charge plusieurs valeurs « Item », mais une seule valeur « All ».

  L’ensemble de ce composant fait autorité.

  "Authoritative"="All"
  

  Seul l’élément spécifié fait autorité. Le format de l’élément nommé est défini par l’enregistreur. Les désignations courantes sont « * » pour indiquer tous les fichiers, « ... » pour indiquer tous les fichiers et sous-répertoires du composant spécifié.

  "Authoritative"="Item:XXX"
  

• Effectuer une restauration

  Une fois qu’une base de données est restaurée, les enregistreurs effectuent généralement une restauration via les journaux pour mettre la base de données à jour. Dans le cas de restaurations incrémentielles ou différentielles, le demandeur utilise la méthode IVssBackupComponents::SetAdditionalRestores pour contrôler partiellement le comportement de gestion des journaux. Cette option de restauration permet un contrôle plus granulaire.

  Ne pas parcourir les journaux.

  "Roll Forward"="None"
  

  Parcourez tous les journaux.

  "Roll Forward"="All"
  

  Parcourez les journaux jusqu’au point spécifié. Le format du point spécifié est défini par l’enregistreur.

  "Roll Forward"="Partial:XXX"
  

• Nom du nouveau composant

  Un writer peut vouloir restaurer un composant sous un nouveau nom. Par exemple, la restauration d’une base de données à un nom différent pour restaurer un élément individuel ; La restauration du même nom plairait à toutes les données Nous recommandons aux rédacteurs d’accepter un chemin logique valide et un nom de composant comme valeur de cette option. Il est souvent utilisé avec une cible dirigée.

  "New Component Name"="Logical Path\Component Name"