Contenu du document de métadonnées writer
Le document de métadonnées de l’enregistreur contient trois jeux de données : informations d’identification et de classification de l’enregistreur, spécifications au niveau de l’enregistreur et données de composant.
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
- Writer instance
- 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ée par l’enregistreur (voir VSS_SOURCE_TYPE)
À l’exception du writer instance, qui est unique et est généré par le système lorsqu’un objet CVssWriter est initialisé, toutes ces valeurs sont définies par un writer lorsqu’il appelle CVssWriter::Initialize et sont disponibles pour un demandeur en appelant IVssExamineWriterMetadata::GetIdentity.
Étant donné que le writer instance est généré de manière unique, un enregistreur stocké instance récupéré à partir d’un document de métadonnées de l’enregistreur stocké n’est probablement pas utile.
En vérifiant VSS_USAGE_TYPE, une application peut déterminer si un writer gère les données générales de l’application, ou si les fichiers avec tableaux qu’elle utilise font partie de 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 qui gère les données à sauvegarder effectue pendant un fonctionnement normal.
Actuellement, la distinction se limite à 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 plus général d’activité. Cette liste peut s’allonger 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 à l’échelle de l’enregistreur dans leur étendue, s’appliquant à toutes les données, indépendamment des composants qui les gèrent.
Un writer doit toujours spécifier des méthodes de restauration.
Elle 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 exclude 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 writer 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 writer indique le mode préféré de restauration de fichiers, également appelé cible de restauration d’origine, pour tous les fichiers gérés par un enregistreur. Par instance, la méthode de restauration spécifie si tous les fichiers gérés par un writer doivent être autorisés à remplacer les fichiers actuellement sur le disque. (Pour plus d’informations, consultez Configurations et VSS_RESTOREMETHOD_ENUM de restauration VSS.)
Exclure la spécification de liste de fichiers
La liste d’exclusions permet d’affiner les spécifications de caractères génériques dans les composants en empêchant explicitement l’inclusion de certains fichiers dans un jeu de sauvegarde.
Par instance, 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 writer ajoute *.tmp à sa liste d’exclusions à l’aide de IVssCreateWriterMetadata::AddExcludeFiles. Cette spécification peut être récursive.
Un demandeur interroge ces informations à l’aide de IVssExamineWriterMetadata::GetExcludeFile.
La liste des 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 se compose de tous les fichiers spécifiés dans les composants explicitement inclus et des composants implicitement inclus , moins tous les fichiers exclus.
Spécification des mappages d’emplacements secondaires
Les mappages d’autres 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 vers 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 en tant que chaîne de caractères larges terminées par null avec IVssCreateWriterMetadata::AddAlternateLocationMapping et récupérées en tant qu’objet IVssWMFiledesc par IVssExamineWriterMetadata::GetAlternateLocationMapping.
Malgré le fait que les mappages d’emplacements alternatifs 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
Les composants 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 d’IVssCreateWriterMetadata::AddComponent, en spécifiant les informations de composant suivantes :
- Type
- Nom
- Chemin logique (le cas échéant)
- Fonctionnalité prise en charge
- Possibilité de sélection
- Métadonnées à utiliser par l’enregistreur lors de la restauration
- Afficher des informations
- Informations de notification
La sélection pour la sauvegarde et la 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 les composants requis pour l’inclusion explicite (ceux qui peuvent être explicitement inclus à la discrétion d’un demandeur) et ceux qui ne peuvent être inclus qu’implicitement. (Voir Utilisation de la possibilité de sélection et des chemins logiques.)
Les fichiers sont ajoutés à un composant donné à l’aide de IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles ou IVssCreateWriterMetadata::AddDatabaseLogFiles. (Voir Ajout de fichiers aux 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 autre chemin d’accès pour la sauvegarde, qui ne doit pas être confondu avec les mappages d’emplacements alternatifs mentionnés précédemment. Ce chemin d’accès alternatif indique un emplacement autre que celui par défaut à partir duquel les fichiers doivent être copiés lorsqu’un volume est sauvegardé.
Les 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 sont retournés dans IVssWMComponent en tant qu’objets IVssWMFiledesc .
Les informations sur les composants d’un writer sont traitées en détail dans Définition des composants par les enregistreurs.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour