Instrucciones RESTORE: LABELONLY (Transact-SQL)RESTORE Statements - LABELONLY (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database (solo Instancia administrada) noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

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.Returns a result set containing information about the backup media identified by the given backup device.

Nota

Para obtener las descripciones de los argumentos, vea Argumentos de RESTORE (Transact-SQL).For the descriptions of the arguments, see RESTORE Arguments (Transact-SQL).

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
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)SQL Server 2012 (11.x) SP1 CU2.URL is the format used to specify the location and the file name for Microsoft Azure Blob Storage and is supported starting with SQL Server 2012 (11.x)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.Although Microsoft Azure storage is a service, the implementation is similar to disk and tape to allow for a consistent and seamless restore experience for all the three devices.

ArgumentosArguments

Para obtener las descripciones de los argumentos de RESTORE LABELONLY, vea Argumentos de RESTORE (Transact-SQL).For descriptions of the RESTORE LABELONLY arguments, see RESTORE Arguments (Transact-SQL).

Conjuntos de resultadosResult Sets

El conjunto de resultados de RESTORE LABELONLY está compuesto de una sola fila con esta información.The result set from RESTORE LABELONLY consists of a single row with this information.

Nombre de columnaColumn name Tipo de datosData type DescripciónDescription
MediaNameMediaName nvarchar(128)nvarchar(128) Nombre del medio.Name of the media.
MediaSetIdMediaSetId uniqueidentifieruniqueidentifier Número de identificación único del conjunto de medios.Unique identification number of the media set.
FamilyCountFamilyCount intint Número de familias de medios en el conjunto de medios.Number of media families in the media set.
FamilySequenceNumberFamilySequenceNumber intint Número de secuencia de esta familia.Sequence number of this family.
MediaFamilyIdMediaFamilyId uniqueidentifieruniqueidentifier Número de identificación único de la familia de medios.Unique identification number for the media family.
MediaSequenceNumberMediaSequenceNumber intint Número de secuencia de este medio en la familia de medios.Sequence number of this media in the media family.
MediaLabelPresentMediaLabelPresent tinyinttinyint Indica si la descripción del medio contiene:Whether the media description contains:

1 = Etiqueta de medio en formato de cinta de MicrosoftMicrosoft1 = MicrosoftMicrosoft Tape Format media label

0 = Descripción del medio0 = Media description
MediaDescriptionMediaDescription nvarchar(255)nvarchar(255) Descripción del medio, en texto sin formato o etiqueta de medio en formato de cinta.Media description, in free-form text, or the Tape Format media label.
SoftwareNameSoftwareName nvarchar(128)nvarchar(128) Nombre del software para realizar copias de seguridad con que se escribió la etiqueta.Name of the backup software that wrote the label.
SoftwareVendorIdSoftwareVendorId intint Número de identificación único del fabricante del software con que se escribió la copia de seguridad.Unique vendor identification number of the software vendor that wrote the backup.
MediaDateMediaDate datetimedatetime Fecha y hora en que se escribió la etiqueta.Date and time the label was written.
Mirror_CountMirror_Count intint Número de reflejos en el conjunto (1-4).Number of mirrors in the set (1-4).

Nota: Las etiquetas escritas para los distintos reflejos de un conjunto son idénticas.Note: The labels written for different mirrors in a set are identical.
IsCompressedIsCompressed bitbit Si la copia de seguridad está comprimida:Whether the backup is compressed:

0 = no comprimida0 = not compressed

1 = comprimida1 =compressed

Nota

Si se definen contraseñas para el conjunto de medios, RESTORE LABELONLY solo mostrará información si se especifica la contraseña correcta en la opción MEDIAPASSWORD del comando.If passwords are defined for the media set, RESTORE LABELONLY returns information only if the correct media password is specified in the MEDIAPASSWORD option of the command.

Notas generalesGeneral Remarks

Ejecutar RESTORE LABELONLY constituye una forma rápida de averiguar el contenido del medio de copia de seguridad.Executing RESTORE LABELONLY is a quick way to find out what the backup media contains. Puesto que RESTORE LABELONLY solo lee el encabezado de medios, esta instrucción finaliza rápidamente incluso cuando se utilizan dispositivos de cinta de alta capacidad.Because RESTORE LABELONLY reads only the media header, this statement finishes quickly even when using high-capacity tape devices.

SeguridadSecurity

Opcionalmente, la operación de copia de seguridad puede especificar contraseñas para un conjunto de medios.A backup operation may optionally specify passwords for a media set. Si se ha definido una contraseña en un conjunto de medios, debe especificar la contraseña correcta en la instrucción RESTORE.When a password has been defined on a media set, you must specify the correct password in the RESTORE statement. Esta contraseña impide operaciones de restauración y anexiones no autorizadas de los conjuntos de copia de seguridad en medios que usan herramientas de MicrosoftMicrosoft SQL ServerSQL Server.The password prevents unauthorized restore operations and unauthorized appends of backup sets to media using MicrosoftMicrosoft SQL ServerSQL Server tools. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.However, a password does not prevent overwrite of media using the BACKUP statement's FORMAT option.

Importante

El nivel de protección que proporciona esta contraseña es bajo.The protection provided by this password is weak. El objetivo es impedir una restauración incorrecta con las herramientas de SQL ServerSQL Server, ya sea por parte de usuarios autorizados o no autorizados.It is intended to prevent an incorrect restore using SQL ServerSQL Server tools by authorized or unauthorized users. No impide la lectura de los datos de las copias de seguridad por otros medios o el reemplazo de la contraseña.It does not prevent the reading of the backup data by other means or the replacement of the password. Esta característica está en modo de mantenimiento y es posible que no se incluya en una versión futura de Microsoft SQL Server.This feature is in maintenance mode and may be removed in a future version of Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.El procedimiento recomendado para proteger las copias de seguridad consiste en almacenar las cintas de copia de seguridad en una ubicación segura o en hacer una copia de seguridad en archivos de disco protegidos con las listas de control de acceso (ACL) adecuadas.The best practice for protecting backups is to store backup tapes in a secure location or back up to disk files that are protected by adequate access control lists (ACLs). Las ACL se deben establecer en el directorio raíz en el que se crean las copias de seguridad.The ACLs should be set on the directory root under which backups are created.

PermisosPermissions

En SQL Server 2008SQL 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.In SQL Server 2008SQL Server 2008 and later versions, obtaining information about a backup set or backup device requires CREATE DATABASE permission. Para obtener más información, vea GRANT (permisos de base de datos de Transact-SQL).For more information, see GRANT Database Permissions (Transact-SQL).

Consulte tambiénSee Also

BACKUP (Transact-SQL) BACKUP (Transact-SQL)
Conjuntos de medios, familias de medios y conjuntos de copias de seguridad (SQL Server) Media Sets, Media Families, and Backup Sets (SQL Server)
RESTORE REWINDONLY (Transact-SQL) RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL) RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL) RESTORE (Transact-SQL)
Historial de copias de seguridad e información de encabezados (SQL Server)Backup History and Header Information (SQL Server)