Instrucciones RESTORE: LABELONLY (Transact-SQL)
Se aplica a: SQL Server
Azure SQL Instancia administrada
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 las descripciones de los argumentos, vea Argumentos de RESTORE (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 obtener las descripciones de los argumentos de RESTORE LABELONLY, vea Argumentos de RESTORE (Transact-SQL).
Conjuntos de resultados
El conjunto de resultados de RESTORE LABELONLY está compuesto de 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 mostrará información si se especifica la contraseña correcta en la opción MEDIAPASSWORD del comando.
Notas generales
Ejecutar RESTORE LABELONLY constituye una forma rápida de averiguar el contenido del medio de copia de seguridad. 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.
Seguridad
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. 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. No obstante, la contraseña no impide que se sobrescriba el medio con la opción FORMAT de la instrucción BACKUP.
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 usar esta característica en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que actualmente usan esta característica. 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, para obtener información sobre un conjunto de copia de seguridad o un dispositivo de copia de seguridad, es necesario el permiso CREATE DATABASE. Para obtener más información, vea Permisos de base de datos GRANT (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)