Instrucciones RESTORE: FILELISTONLY (Transact-SQL)

Artículo
05/30/2023

Se aplica a: SQL Server Azure SQL Instancia administrada

Devuelve un conjunto de resultados que contiene una lista con los archivos de base de datos y de registro del conjunto de copia de seguridad de SQL Server.

Nota:

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

RESTORE FILELISTONLY   
FROM <backup_device>   
[ WITH   
 {  
--Backup Set Options  
   FILE = { backup_set_file_number | @backup_set_file_number }   
 | PASSWORD = { password | @password_variable }   
 | [ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { database_name | @database_name_variable } ]
  
--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 FILELISTONLY, vea Argumentos de RESTORE (Transact-SQL).

Conjuntos de resultados

Un cliente puede utilizar RESTORE FILELISTONLY para obtener una lista de los archivos que contiene el conjunto de copia de seguridad. Esta información se devuelve como conjunto de resultados que contiene una fila por cada archivo.

Nombre de la columna	Tipo de datos	Descripción
LogicalName	nvarchar(128)	Nombre lógico del archivo.
PhysicalName	nvarchar(260)	Nombre físico o del sistema operativo del archivo.
Tipo	char(1)	Uno de los tipos de archivo: L = archivo de registro de Microsoft SQL Server D = archivo de datos de SQL Server F = catálogo de texto completo S = FileStream, FileTable o contenedor de OLTP en memoria
FileGroupName	nvarchar(128) NULL	Nombre del grupo de archivos que contiene el archivo.
Size	numeric(20,0)	Tamaño actual, en bytes.
MaxSize	numeric(20,0)	Tamaño máximo permitido, en bytes.
FileID	bigint	Identificador de archivo, único en la base de datos.
CreateLSN	numeric(25,0)	Número de secuencia de registro en el que se creó el archivo.
DropLSN	numeric(25,0) NULL	Número de secuencia de registro en que se quitó el archivo. Si el archivo no se ha quitado, este valor es NULL.
UniqueID	uniqueidentifier	Identificador único global del archivo.
ReadOnlyLSN	numeric(25,0) NULL	Número de flujo de registro en el que el grupo de archivos que contiene el archivo cambió de lectura/escritura a solo lectura (el cambio más reciente).
ReadWriteLSN	numeric(25,0) NULL	Número de secuencia de registro en el que el grupo de archivos que contiene el archivo cambió de solo lectura a lectura/escritura (el cambio más reciente).
BackupSizeInBytes	bigint	Tamaño en bytes de la copia de seguridad de este archivo.
SourceBlockSize	int	Tamaño de bloque (en bytes) del dispositivo físico que contiene el archivo (no el dispositivo de copia de seguridad).
FileGroupID	int	Id. del grupo de archivos.
LogGroupGUID	uniqueidentifier NULL	NULL.
DifferentialBaseLSN	numeric(25,0) NULL	En el caso de las copias de seguridad diferenciales, los cambios cuyo número de secuencia de registro sea mayor o igual que DifferentialBaseLSN se incluyen en la copia diferencial. Para otros tipos de copia de seguridad, el valor es NULL.
DifferentialBaseGUID	uniqueidentifier NULL	Identificador único de la base diferencial, en el caso de las copias de seguridad diferenciales. Para otros tipos de copia de seguridad, el valor es NULL.
IsReadOnly	bit	1 = El archivo es de solo lectura.
IsPresent	bit	1 = El archivo se encuentra en la copia de seguridad.
TDEThumbprint	varbinary(32) NULL	Muestra la huella digital de la clave de cifrado de base de datos. La huella digital de la clave de cifrado es el valor hash SHA-1 del certificado con el que se cifra la clave. Para obtener más información sobre el cifrado de bases de datos, vea Cifrado de datos transparente (TDE).
SnapshotURL	nvarchar(360) NULL	Se aplica a: SQL Server (SQL Server 2016 (13.x) (CU1) a lo largo de la versión actual. Dirección URL de la instantánea de Azure del archivo de base de datos incluido en la copia de seguridad de FILE_SNAPSHOT. Devuelve NULL si no hay ninguna copia de seguridad de FILE_SNAPSHOT.

Seguridad

La operación de copia de seguridad puede especificar opcionalmente contraseñas para un conjunto de medios, para un conjunto de copia de seguridad o para ambos. Si se ha definido una contraseña en un conjunto de medios o un conjunto de copia de seguridad, debe especificar la contraseña o contraseñas correctas en la instrucción RESTORE. Estas contraseñas impiden 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 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. Las ACL se deben establecer en el directorio raíz en el que se crean las copias de seguridad.

Permisos

A partir de SQL Server 2008 (10.0.x), 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).

Ejemplos

En el siguiente ejemplo se devuelve la información de un dispositivo de copia de seguridad denominado AdventureWorksBackups. El ejemplo utiliza la opción FILE para especificar el segundo conjunto de copias de seguridad del dispositivo.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO

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)

Compartir vía