RESTORE LABELONLY (Transact-SQL)

Devuelve un conjunto de resultados que contiene información acerca del medio de copia de seguridad identificado por el dispositivo de copia de seguridad dado.

Nota

Para obtener descripciones de los argumentos, vea RESTORE (argumentos, Transact-SQL).

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

RESTORE LABELONLY 
FROM <backup_device> 
[ WITH 
 {
--Media Set Options
   MEDIANAME = { media_name | @media_name_variable } 
 | MEDIAPASSWORD = { mediapassword | @mediapassword_variable }
  
--Error Management Options
  | { CHECKSUM | NO_CHECKSUM } 
 | { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

--Tape Options
 | { REWIND | NOREWIND } 
 | { UNLOAD | NOUNLOAD }  
  } [ ,...n ]
]
[;]

<backup_device> ::=
{ 
   { logical_backup_device_name |
            @logical_backup_device_name_var }
   | { DISK | TAPE } = { 'physical_backup_device_name' |
              @physical_backup_device_name_var } 
} 

Argumentos

Para obtener descripciones de los argumentos de RESTORE LABELONLY, vea RESTORE (argumentos, Transact-SQL).

Conjuntos de resultados

El conjunto de resultados de RESTORE LABELONLY está compuesto de una sola fila con esta información.

Nombre de columna

Tipo de datos

Descripción

MediaName

nvarchar(128)

Nombre del medio.

MediaSetId

uniqueidentifier

Número de identificación único del conjunto de medios.

FamilyCount

int

Número de familias de medios en el conjunto de medios.

FamilySequenceNumber

int

Número de secuencia de esta familia.

MediaFamilyId

uniqueidentifier

Número de identificación único de la familia de medios.

MediaSequenceNumber

int

Número de secuencia de este medio en la familia de medios.

MediaLabelPresent

tinyint

Indica si la descripción del medio contiene:

1 = Etiqueta de medio en formato de cinta de Microsoft

0 = Descripción del medio

MediaDescription

nvarchar(255)

Descripción del medio, en texto sin formato o etiqueta de medio en formato de cinta.

SoftwareName

nvarchar(128)

Nombre del software para realizar copias de seguridad con que se escribió la etiqueta.

SoftwareVendorId

int

Número de identificación único del fabricante del software con que se escribió la copia de seguridad.

MediaDate

datetime

Fecha y hora en que se escribió la etiqueta.

Mirror_Count

int

Número de reflejos en el conjunto (1-4).

NotaNota
Las etiquetas escritas para los distintos reflejos de un conjunto son idénticas.

IsCompressed

bit

Si la copia de seguridad está comprimida:

0 = no comprimida

1 = comprimida

Nota

Si se definen contraseñas para el conjunto de medios, RESTORE LABELONLY sólo mostrará información si se especifica la contraseña correcta en la opción MEDIAPASSWORD del comando.

Comentarios

Ejecutar RESTORE LABELONLY constituye una forma rápida de averiguar el contenido del medio de copia de seguridad. Debido a que RESTORE LABELONLY sólo lee el encabezado del medio, esta instrucción finaliza rápidamente incluso cuando se utilizan dispositivos de cinta de alta capacidad.

Permisos

En SQL Server 2008 y versiones posteriores, la obtención de información sobre un conjunto de copia de seguridad o un dispositivo de copia de seguridad requiere el permiso CREATE DATABASE. Para obtener más información, vea GRANT (permisos de base de datos de Transact-SQL).

Opcionalmente, la operación de copia de seguridad puede especificar contraseñas para un conjunto de medios. Si se ha definido una contraseña en un conjunto de medios, debe especificar la contraseña correcta en la instrucción RESTORE. Esta contraseña impide operaciones de restauración y anexiones no autorizadas de los conjuntos de copia de seguridad en medios que utilizan herramientas de Microsoft SQL Server. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.

Nota de seguridadNota de seguridad

El nivel de protección que proporciona esta contraseña es bajo. El objetivo es impedir una restauración incorrecta mediante las herramientas de SQL Server ya sea por parte de usuarios autorizados o no autorizados. No impide la lectura de los datos de las copias de seguridad por otros medios o el reemplazo de la contraseña. Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. La práctica recomendada para proteger las copias de seguridad consiste en almacenar las cintas de copia de seguridad en una ubicación segura o hacer una copia de seguridad en archivos de disco protegidos mediante las listas de control de acceso (ACL) adecuadas. The ACLs should be set on the directory root under which backups are created.