Contenido del documento de metadatos del escritor

  • Artículo

El documento de metadatos del escritor contiene tres conjuntos de datos: información de identificación y clasificación del escritor, especificaciones de nivel de escritor y datos de componentes.

Información de identificación del escritor

La información de identificación y clasificación del escritor incluye lo siguiente:

Con la excepción de la instancia de escritor, que es única y se genera por el sistema cuando se inicializa un objeto CVssWriter , un escritor establece todos estos valores cuando llama a CVssWriter::Initialize y está disponible para un solicitante mediante una llamada a IVssExamineWriterMetadata::GetIdentity.

Dado que la instancia de escritor se genera de forma única, es probable que una instancia de escritor almacenada recuperada de un documento de metadatos del escritor almacenado no sea útil.

Al comprobar VSS_USAGE_TYPE, una aplicación puede determinar si un escritor administra datos generales de la aplicación o si los archivos con los que funciona forman parte del estado de arranque del sistema o los usa un servicio del sistema. Las aplicaciones de copia de seguridad y restauración deben respetar los tipos de uso para ayudar a mantener la estabilidad del sistema.

La marca VSS_SOURCE_TYPE indica qué tipo de aplicación administra el escritor que administra los datos de los que se va a realizar una copia de seguridad durante el funcionamiento normal.

Actualmente, la distinción se limita a especificar si el escritor genera archivos como parte de las operaciones de base de datos transaccionales o no transaccionales, o si los archivos son el resultado de un tipo de actividad más general. Esta lista puede crecer con el tiempo. Esta información puede ser útil para determinar el nivel normal de actividad esperado en los archivos de un escritor.

especificación de Writer-Level

Las especificaciones de nivel de escritor contienen información que es un escritor amplio en su ámbito, que se aplica a todos los datos independientemente del cual un componente lo administre.

Un escritor siempre debe especificar métodos de restauración.

Opcionalmente, puede especificar lo siguiente:

Las listas de archivos de inclusión y exclusión contienen información de archivo más allá de eso en los componentes y su especificación sustituye a la especificación del componente.

Especificación del método Restore

El método restore se establece en el documento de metadatos de escritor por IVssCreateWriterMetadata::SetRestoreMethod y recuperado por un solicitante con IVssExamineWriterMetadata::GetRestoreMethod.

Al establecer un método de restauración, un escritor indica la manera preferida de restauración de archivos, también conocida como destino de restauración original, para todos los archivos administrados por un escritor. Por ejemplo, el método restore especifica si todos los archivos administrados por un escritor deben poder sobrescribir archivos actualmente en el disco. (Consulte Configuraciones de restauración de VSS y VSS_RESTOREMETHOD_ENUM para obtener más información).

Excluir especificación de lista de archivos

La lista de exclusión permite ajustar explícitamente las especificaciones de caracteres comodín en los componentes evitando explícitamente que determinados archivos se incluyan en un conjunto de copia de seguridad.

Por ejemplo, un componente puede tener un conjunto de archivos que contenga una especificación de archivo de c:\Database\*.*. Aunque se trata de una definición conveniente, en ocasiones puede haber archivos temporales generados (quizás con el formato *.tmp), y el escritor siempre quiere impedir su copia de seguridad.

En este caso, un escritor agregaría *.tmp a su lista de exclusión mediante IVssCreateWriterMetadata::AddExcludeFiles. Esta especificación podría ser recursiva.

Un solicitante consultaría esta información mediante IVssExamineWriterMetadata::GetExcludeFile.

La lista de archivos de exclusión tiene prioridad sobre las listas de archivos de componentes.

Por lo tanto, la lista de archivos especificados para la copia de seguridad en un documento de metadatos de escritor constaría de todos los archivos especificados en los componentes incluidos explícitamente y los componentes incluidos implícitamente , menos todos los archivos excluidos.

Especificación de asignaciones de ubicación alternativas

Las asignaciones de ubicación alternativas se establecen inicialmente durante la creación de un documento de metadatos del escritor e indican una ubicación en el disco en la que se pueden restaurar los archivos si no es posible restaurar un archivo en la ubicación original.

La información se agrega como una cadena de caracteres anchos terminada en null con IVssCreateWriterMetadata::AddAlternateLocationMapping y se recupera como un objeto IVssWMFiledesc por IVssExamineWriterMetadata::GetAlternateLocationMapping.

A pesar de que se especifican y examinan las asignaciones de ubicación alternativas mediante las interfaces de nivel de escritor (IVssCreateWriterMetadata e IVssExamineWriterMetadata), se especifican en términos de conjuntos de archivos. El conjunto de archivos usado para especificar una asignación de ubicación alternativa (ruta de acceso, especificación de archivo y marca de recursividad) debe coincidir con uno de los conjuntos de archivos ya agregados a uno de los componentes del escritor (consulte Agregar archivos a componentes).

Para obtener más información, vea Ubicaciones de copia de seguridad y restauración no predeterminadas.

información de Component-Level

Los componentes son colecciones de archivos que forman una unidad lógica con fines de copia de seguridad y restauración. Todos los archivos de un componente (excepto los excluidos explícitamente) se deben realizar copias de seguridad y restaurarse como una unidad.

Los escritores agregan componentes mediante IVssCreateWriterMetadata::AddComponent, especificando la siguiente información de componentes:

  • Tipo
  • Nombre
  • Ruta de acceso lógica (si existe)
  • Característica admitida
  • Capacidad de selección
  • Metadatos que va a usar el escritor durante la restauración
  • Mostrar información
  • Información de notificación

La capacidad de selección para la copia de seguridad y la capacidad de selección para la restauración son completamente independientes entre sí y un escritor los usa junto con rutas lógicas para indicar las relaciones entre los distintos componentes que administra. Los escritores pueden indicar qué componentes son necesarios para incluirse explícitamente (aquellos que pueden incluirse explícitamente a discreción de un solicitante) y aquellos que solo se pueden incluir implícitamente. (Consulte Trabajar con la capacidad de selección y las rutas de acceso lógicas).

Los archivos se agregan a un componente determinado mediante IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles o IVssCreateWriterMetadata::AddDatabaseLogFiles. (Vea Agregar archivos a componentes).

Al agregar archivos a un componente durante la copia de seguridad, un escritor debe especificar un conjunto de archivos (una ruta de acceso, una especificación de archivo y una marca de recursividad) que defina los archivos de los que se va a realizar una copia de seguridad.

Los escritores también pueden especificar una ruta de acceso alternativa para la copia de seguridad, que no debe confundirse con las asignaciones de ubicación alternativas mencionadas anteriormente. Esta ruta de acceso alternativa indica una ubicación no predeterminada desde la que se van a copiar los archivos cuando se realiza una copia de seguridad de un volumen.

La información sobre un componente determinado en el documento de metadatos de escritor se puede obtener a través de una interfaz IVssWMComponent devuelta por IVssExamineWriterMetadata::GetComponent.

Los archivos y rutas de acceso se devuelven en IVssWMComponent como objetos IVssWMFiledesc .

La información de componentes de un escritor se describe en detalle en Definición de componentes por escritores.