Freigeben über


Inhalt des Writer-Metadatendokuments

Das Writer-Metadatendokument enthält drei Datensätze: Writer-Identifikations- und Klassifizierungsinformationen, Spezifikationen auf Writer-Ebene und Komponentendaten.

Writer Identification Information

Die Informationen zur Autorenidentifizierung und Klassifizierung umfassen Folgendes:

Mit Ausnahme der Writer-Instanz, die eindeutig ist und vom System generiert wird, wenn ein CVssWriter-Objekt initialisiert wird, werden alle diese Werte von einem Writer festgelegt, wenn er CVssWriter::Initialize aufruft und für einen Antragsteller verfügbar ist, indem IVssExamineWriterMetadata::GetIdentityaufgerufen wird.

Da die Writer-Instanz eindeutig generiert wird, ist eine gespeicherte Writer-Instanz, die aus einem gespeicherten Writer-Metadatendokument abgerufen wurde, wahrscheinlich nicht hilfreich.

Durch überprüfung VSS_USAGE_TYPEkann eine Anwendung ermitteln, ob ein Writer allgemeine Anwendungsdaten verwaltet oder ob die darin verwendeten Dateien Teil des Startzustands des Systems sind oder von einem Systemdienst verwendet werden. Sicherungs- und Wiederherstellungsanwendungen müssen Verwendungstypen berücksichtigen, um die Systemstabilität aufrechtzuerhalten.

Das kennzeichen VSS_SOURCE_TYPE gibt an, welche Art von Anwendung der Writer verwaltet, der die zu sichernden Daten während des normalen Vorgangs verwaltet.

Derzeit ist die Unterscheidung darauf beschränkt, anzugeben, ob der Writer Dateien als Teil von Transaktions- oder nichttransaktionalen Datenbankvorgängen erzeugt, oder wenn die Dateien das Ergebnis einer allgemeineren Aktivitätsart sind. Diese Liste kann im Laufe der Zeit wachsen. Diese Informationen können hilfreich sein, um die normale Aktivitätsstufe zu bestimmen, die in den Dateien eines Autors erwartet wird.

Writer-Level Spezifikation

Spezifikationen auf Writer-Ebene enthalten Informationen, die in ihrem Umfang breit schreiben und auf alle Daten angewendet werden, die unabhängig davon sind, welche Komponente sie verwaltet.

Ein Writer muss immer Wiederherstellungsmethodenangeben.

Optional kann Folgendes angegeben werden:

Die Listen zum Einschließen und Ausschließen von Dateien enthalten Dateiinformationen darüber hinaus in den Komponenten, und ihre Spezifikation ersetzt die Komponentenspezifikation.

Spezifikation der Restore-Methode

Die Wiederherstellungsmethode wird im Writer-Metadatendokument durch IVssCreateWriterMetadata::SetRestoreMethod festgelegt und von einem Anforderer mit IVssExamineWriterMetadata::GetRestoreMethodabgerufen.

Beim Festlegen einer Wiederherstellungsmethode gibt ein Writer die bevorzugte Art der Dateiwiederherstellung an, die auch als ursprüngliches Wiederherstellungsziel bezeichnet wird, für alle Dateien, die von einem Writer verwaltet werden. Die Wiederherstellungsmethode gibt beispielsweise an, ob alle dateien, die von einem Writer verwaltet werden, dateien überschreiben dürfen, die sich derzeit auf dem Datenträger befinden. (Weitere Informationen finden Sie unter VSS Restore Configurations und VSS_RESTOREMETHOD_ENUM.)

Dateilistenspezifikation ausschließen

Die Ausschlussliste ermöglicht die Feinabstimmung von Wildcardspezifikationen in Komponenten, indem explizit verhindert wird, dass bestimmte Dateien in einen Sicherungssatz aufgenommen werden.

Beispielsweise kann eine Komponente einen Dateisatz enthalten, der eine Dateispezifikation von c:\Database\*.*enthält. Obwohl dies eine bequeme Definition ist, können gelegentlich temporäre Dateien generiert werden (z. B. form *.tmp), und der Autor möchte immer seine Sicherung verhindern.

In diesem Fall würde ein Writer *.tmp zur Ausschlussliste mithilfe von IVssCreateWriterMetadata::AddExcludeFileshinzufügen. Diese Spezifikation könnte rekursiv sein.

Ein Anforderer würde diese Informationen mithilfe von IVssExamineWriterMetadata::GetExcludeFileabfragen.

Die Ausschlussdateiliste hat Vorrang vor Komponentendateienlisten.

Daher würde die Liste der Dateien, die für die Sicherung in einem Writer-Metadatendokument angegeben sind, aus allen dateien bestehen, die in der explizit Komponenten und die implizit Komponenten enthalten, weniger alle ausgeschlossenen Dateien.

Alternative Standortzuordnungsspezifikation

Alternative Speicherortzuordnungen werden anfänglich beim Erstellen eines Writer-Metadatendokuments festgelegt und geben einen Speicherort auf dem Datenträger an, auf dem Dateien wiederhergestellt werden können, wenn die Wiederherstellung einer Datei an den ursprünglichen Speicherort nicht möglich ist.

Die Informationen werden als durch Null beendete breite Zeichenfolge mit IVssCreateWriterMetadata::AddAlternateLocationMapping hinzugefügt und als IVssWMFiledesc--Objekt durch IVssExamineWriterMetadata::GetAlternateLocationMappingabgerufen.

Trotz der Tatsache, dass alternative Standortzuordnungen mithilfe der Writer-Level-Schnittstellen angegeben und untersucht werden (IVssCreateWriterMetadata und IVssExamineWriterMetadata), werden sie in Bezug auf Dateisätzeangegeben. Der Dateisatz, der beim Angeben einer alternativen Speicherortzuordnung (Pfad, Dateispezifikation und Rekursionskennzeichen) verwendet wird, muss mit einem der Dateisätze übereinstimmen, die bereits zu einer der Komponenten des Autors hinzugefügt wurden (siehe Hinzufügen von Dateien zu Komponenten).

Weitere Informationen finden Sie unter nicht standardmäßigen Sicherungs- und Wiederherstellungsspeicherorten.

Component-Level Informationen

Komponenten sind Sammlungen von Dateien, die eine logische Einheit zum Zweck der Sicherung und Wiederherstellung bilden. Alle Dateien in einer Komponente (mit Ausnahme der explizit ausgeschlossenen) müssen gesichert und als Einheit wiederhergestellt werden.

Autoren fügen Komponenten mithilfe von IVssCreateWriterMetadata::AddComponenthinzu, wobei die folgenden Komponenteninformationen angegeben werden:

  • Art
  • Name
  • Logischer Pfad (falls vorhanden)
  • Unterstütztes Feature
  • Auswahlmöglichkeit
  • Metadaten, die während der Wiederherstellung vom Writer verwendet werden sollen
  • Anzeigen von Informationen
  • Benachrichtigungsinformationen

Auswahlmöglichkeit für die Sicherung und Auswahlmöglichkeiten für die Wiederherstellung sind vollständig unabhängig voneinander, und ein Writer verwendet sie in Verbindung mit logischen Pfaden, um Beziehungen zwischen den verschiedenen verwalteten Komponenten anzugeben. Autoren können angeben, welche Komponenten für explizit eingeschlossenen erforderlich sind (diejenigen, die explizit nach Ermessen eines Antragstellers eingeschlossen werden können), und diejenigen, die nur impliziteingeschlossen werden können. (Siehe Arbeiten mit Auswahlmöglichkeiten und logischen Pfaden.)

Dateien werden einer bestimmten Komponente mithilfe IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFilesoder IVssCreateWriterMetadata::AddDatabaseLogFileshinzugefügt. (Siehe Hinzufügen von Dateien zu Komponenten.)

Beim Hinzufügen von Dateien zu einer Komponente während der Sicherung muss ein Writer einen Dateisatz (Pfad, Dateispezifikation und Rekursionskennzeichen) angeben, der die zu sichernden Dateien definiert.

Autoren können auch einen alternativen Pfad für die Sicherung angeben, der nicht mit alternativen Standortzuordnungen zuvor erwähnt werden sollte. Dieser alternative Pfad gibt einen nicht standardmäßigen Speicherort an, von dem Dateien kopiert werden sollen, wenn ein Volume gesichert wird.

Informationen zu einer bestimmten Komponente im Writer-Metadatendokument können über eine IVssWMComponent Schnittstelle abgerufen werden, die von IVssExamineWriterMetadata::GetComponentzurückgegeben wird.

Die Dateien und Pfade werden in IVssWMComponent als IVssWMFiledesc--Objekte zurückgegeben.

Die Komponenteninformationen eines Autors werden in Definition von Komponenten durch Autorenausführlich erläutert.