Contenu du document de métadonnées de l’enregistreur

Le document de métadonnées de l’enregistreur contient trois jeux de données : les informations d’identification et de classification de l’enregistreur, les spécifications au niveau de l’enregistreur et les données des composants.

Informations d’identification de l’enregistreur

Les informations d’identification et de classification de l’enregistreur incluent les éléments suivants :

• Nom de l’enregistreur
• ID de classe writer
• 'instance Writer
• Comment les données gérées par l’enregistreur sont utilisées sur le système hôte (voir VSS_USAGE_TYPE)
• Type de données gérées par l’enregistreur (voir VSS_SOURCE_TYPE)

À l’exception de l’instance d’enregistreur, qui est unique et générée par le système lorsqu’un objet CVssWriter est initialisé, toutes ces valeurs sont définies par un enregistreur lorsqu’il appelle CVssWriter ::Initialize et sont disponibles pour un demandeur en appelant IVssExamineWriterMetadata ::GetIdentity.

Étant donné que l’instance de l’enregistreur est générée de manière unique, une instance d’enregistreur stockée récupérée à partir d’un document de métadonnées d’enregistreur stocké n’est probablement pas utile.

En vérifiant VSS_USAGE_TYPE, une application peut déterminer si un enregistreur gère des données d’application générales, ou si les fichiers avec utilisant l’état de démarrage du système ou sont utilisés par un service système. Les applications de sauvegarde et de restauration doivent respecter les types d’utilisation pour aider à maintenir la stabilité du système.

L’indicateur VSS_SOURCE_TYPE indique le type d’application que l’enregistreur gérant les données à sauvegarder effectue pendant l’opération normale.

Actuellement, la distinction est limitée à spécifier si l’enregistreur produit des fichiers dans le cadre d’opérations de base de données transactionnelles ou non transactionnelles, ou si les fichiers sont le résultat d’un type d’activité plus général. Cette liste peut croître au fil du temps. Ces informations peuvent être utiles pour déterminer le niveau d’activité ordinaire attendu dans les fichiers d’un enregistreur.

Spécification Writer-Level

Les spécifications au niveau de l’enregistreur contiennent des informations qui sont à l’échelle de l’enregistreur dans son étendue, s’appliquant à toutes les données indépendantes de laquelle un composant le gère.

Un enregistreur doit toujours spécifier méthodes de restauration.

Il peut éventuellement spécifier les éléments suivants :

• Exclure la liste des fichiers
• mappages d’emplacements alternatifs pour la restauration

Les listes de fichiers include et exclure contiennent des informations de fichier au-delà de celles des composants, et leur spécification remplace la spécification des composants.

Spécification de la méthode Restore

La méthode de restauration est définie dans le document de métadonnées de l’enregistreur par IVssCreateWriterMetadata ::SetRestoreMethod et récupérée par un demandeur avec IVssExamineWriterMetadata ::GetRestoreMethod.

Lors de la définition d’une méthode de restauration, un enregistreur indique la manière recommandée de restauration de fichiers, également appelée cible de restauration d’origine, pour tous les fichiers gérés par un enregistreur. Par exemple, la méthode de restauration spécifie si tous les fichiers gérés par un enregistreur doivent être autorisés à remplacer les fichiers actuellement sur le disque. (Pour plus d’informations, consultez configurations de restauration VSS et VSS_RESTOREMETHOD_ENUM.)

Exclure la spécification de la liste de fichiers

La liste d’exclusion permet un réglage précis des spécifications génériques dans les composants en empêchant explicitement certains fichiers d’être inclus dans un jeu de sauvegarde.

Par exemple, un composant peut avoir un jeu de fichiers contenant une spécification de fichier c :\Database\*.*. Bien qu’il s’agit d’une définition pratique, il peut parfois y avoir des fichiers temporaires générés (peut-être sous la forme *.tmp), et l’enregistreur souhaite toujours empêcher leur sauvegarde.

Dans ce cas, un enregistreur ajouterait *.tmp à sa liste d’exclusion à l’aide de IVssCreateWriterMetadata ::AddExcludeFiles. Cette spécification peut être récursive.

Un demandeur interroge ces informations à l’aide de IVssExamineWriterMetadata ::GetExcludeFile.

La liste de fichiers d’exclusion est prioritaire sur les listes de fichiers de composants.

Ainsi, la liste des fichiers spécifiés pour la sauvegarde dans un document de métadonnées writer consisterait à tous les fichiers spécifiés dans les composants explicitement inclus et les implicitement inclus composants, moins tous les fichiers exclus.

Spécification des mappages d’emplacements alternatifs

D’autres mappages d’emplacements sont initialement définis lors de la création d’un document de métadonnées writer et indiquent un emplacement sur le disque sur lequel les fichiers peuvent être restaurés si la restauration d’un fichier à l’emplacement d’origine n’est pas possible.

Les informations sont ajoutées sous la forme d’une chaîne de caractères large avec IVssCreateWriterMetadata ::AddAlternateLocationMapping et récupérées en tant qu’objet IVssWMFiledesc par IVssExamineWriterMetadata ::GetAlternateLocationMapping.

Malgré le fait que d’autres mappages d’emplacements sont spécifiés et examinés à l’aide des interfaces au niveau de l’enregistreur (IVssCreateWriterMetadata et IVssExamineWriterMetadata), ils sont spécifiés en termes de jeux de fichiers . Le jeu de fichiers utilisé pour spécifier un autre mappage d’emplacement (chemin d’accès, spécification de fichier et indicateur de récursivité) doit correspondre à l’un des jeux de fichiers déjà ajoutés à l’un des composants de l’enregistreur (voir Ajout de fichiers aux composants).

Pour plus d’informations, consultez emplacements de sauvegarde et de restauration non par défaut.

informations Component-Level

Components sont des collections de fichiers qui forment une unité logique à des fins de sauvegarde et de restauration. Tous les fichiers d’un composant (à l’exception de ceux explicitement exclus) doivent être sauvegardés et restaurés en tant qu’unité.

Les enregistreurs ajoutent des composants à l’aide de IVssCreateWriterMetadata ::AddComponent, en spécifiant les informations de composant suivantes :

• Type
• Nom
• Chemin logique (le cas échéant)
• Fonctionnalité prise en charge
• de sélection
• Métadonnées à utiliser par l’enregistreur pendant la restauration
• Afficher des informations
• Informations de notification

sélectabilité des de sauvegarde et possibilité de sélection pour la restauration sont complètement indépendantes les unes des autres, et un enregistreur les utilise conjointement avec des chemins logiques pour indiquer les relations entre les différents composants qu’il gère. Les enregistreurs peuvent indiquer quels composants sont requis pour inclus explicitement (ceux qui peuvent être explicitement inclus à la discrétion d’un demandeur) et ceux qui ne peuvent être implicitement inclus. (Consultez Utilisation de la sélection et des chemins logiques.)

Les fichiers sont ajoutés à un composant donné à l’aide de IVssCreateWriterMetadata ::AddFilesToFileGroup, IVssCreateWriterMetadata ::AddDatabaseFiles, ou IVssCreateWriterMetadata ::AddDatabaseLogFiles. (Consultez Ajout de fichiers à des composants.)

Lors de l’ajout de fichiers à un composant pendant la sauvegarde, un enregistreur doit spécifier un jeu de fichiers (un chemin d’accès, une spécification de fichier et un indicateur de récursivité) qui définit les fichiers à sauvegarder.

Les enregistreurs peuvent également spécifier un chemin d’accès alternatif pour la sauvegarde, ce qui ne doit pas être confondu avec mappages d’emplacements alternatifs mentionnés précédemment. Ce chemin d’accès alternatif indique un emplacement non par défaut à partir duquel les fichiers doivent être copiés lorsqu’un volume est sauvegardé.

Des informations sur un composant donné dans le document de métadonnées writer peuvent être obtenues via une interface IVssWMComponent retournée par IVssExamineWriterMetadata ::GetComponent.

Les fichiers et chemins d’accès sont retournés dans IVssWMComponent en tant qu’objets IVssWMFiledesc.

Les informations sur les composants d’un enregistreur sont présentées en détail dans Définition des composants par writer.