RESTORE Declaraciones - LABELONLY (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

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 las descripciones de los argumentos, véase RESTORE Argumentos (Transact-SQL).

Convenciones 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 | URL } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}

Nota

URL es el formato que se usa para especificar la ubicación y el nombre del archivo para Microsoft Azure Blob Storage y se admite a partir de SQL Server 2012 (11.x) SP1 CU2. Aunque Microsoft Azure Storage es un servicio, la implementación es similar al disco y la cinta para permitir una experiencia de restauración coherente y sin problemas para los tres dispositivos.

Argumentos

Para descripciones de los RESTORE LABELONLY argumentos, véase RESTORE Argumentos (Transact-SQL).

Conjuntos de resultados

El conjunto de resultados de RESTORE LABELONLY consiste en una sola fila con esta información.

Nombre de la 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).

Nota: 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 solo devuelve la información si la contraseña correcta del medio está especificada en la opción MEDIAPASSWORD del comando.

Notas generales

Ejecutar RESTORE LABELONLY es una forma rápida de averiguar qué contiene el soporte de respaldo. Como RESTORE LABELONLY solo lee el encabezado multimedia, esta declaración termina rápidamente incluso usando dispositivos de cinta de alta capacidad.

Seguridad

Opcionalmente, la operación de copia de seguridad puede especificar contraseñas para un conjunto de medios. Cuando se haya definido una contraseña en un set multimedia, debes especificar la contraseña correcta en la RESTORE declaración. La 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. Sin embargo, una contraseña no impide la sobrescritura de medios usando la BACKUP opción FORMAT de la sentencia.

Importante

El nivel de protección que proporciona esta contraseña es bajo. El objetivo es impedir una restauración incorrecta con 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 SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. El procedimiento recomendado para proteger las copias de seguridad es almacenar cintas de copia de seguridad en una ubicación segura o realizar copias de seguridad en archivos de disco protegidos por listas de control de acceso (ACL) adecuadas. Las ACL se deben establecer en el directorio raíz en el que se crean las copias de seguridad.

Permisos

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

Consulte también

BACKUP (Transact-SQL)
Conjuntos de medios, familias de medios y conjuntos de copias de seguridad (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Historial de copias de seguridad e información de encabezados (SQL Server)

  • Last updated on